API
A public API is available for querying all published QC Test definitions, including links to the famous 'Card' images.
The official documentation for this API is available from: github.com/ebu/qc (public).
Documentation
The API definition is only one part of the available documentation.
The github.com/ebu/qc repo also contains:
- The QC Data Model
- XML Scheams for both the API and the Data Model specifications
- Oldver versions of above specifications.
API versions
v2
Since release v.4.68.0 API v2 functionality is available on qc.ebu.io (this uses the '2026-01' tagged XSD).
Automatically generated Swagger documentation for the qc.ebu.io/api/v2 implementation is at: qc.ebu.io/swagger-ui/
V1
API version 1 is also still supported on qc.ebu.io.
Example API v2 calls
https://ebu.io/qc/api/v2/items returns all published (and any withdrawn) Test Items, including detailed information for the latest published/deprecated one!
https://ebu.io/qc/api/v2/items/0001F returns a specific Test Item
https://ebu.io/qc/api/v2/items/0001F/versions/2.0 returns a specific version of a Test Item
Fair use (rate limiting)
The API calls are limited in time & amount.
Requests also can be cached, so you may get a 429 if you already got the latest information. See the API documentation for more details.
Additional (non-standardised) functionality
See this swagger documentation: https://qc.ebu.io/management-api/swagger-ui/ for additional API functionality that is NOT part of the official API v2 implementation.
These extra functions are provided on qc.ebu.io on a best-effort basis. They are especially meant to help with the management (creation, versioning, etc.) of the QC Items.
API v1 extension
Since 01 June 2023, a non-official flag has been available for API v1. This flag allows the export of all Items in CSV or JSON:
https://qc.ebu.io/api/v1/items?output-format=csv
https://qc.ebu.io/api/v1/items?output-format=json
If you specify an unrecognized output-format, XML will be used as the default.
If you use an unrecognized query format (e.g. misspelled 'outputformat'), you will get an emtpy result.
Feedback
To report any issues with or make suggestions for the data model or API use the issues tracker at: github.com/ebu/qc/issues
For any roblems with or suggestion for this qc.ebu.io implementation, you can contact Frans de Jong (dejong@ebu.ch) or the generic EBU address at: tech@ebu.ch.