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 Schemas for both the API and the Data Model specifications
- Older versions of the above specifications.
API versions
v2
Since release v4.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/
qc.ebu.io also provides a built-in API v2 validator.
V1
API version 1 is also still supported on qc.ebu.io.
Note that a trailing slash in API calls has been supported, but is not spec-conform. Since v4.107.2 for both APIs (v1 and v2) qc.ebu.io still reply to calls with a trailing slash, but respond with a HTTP 301 to make the caller aware of the correct API call format.
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 (types, units, 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 empty 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 problems with or suggestions for this qc.ebu.io implementation, you can contact Frans de Jong (dejong@ebu.ch) or the generic EBU address at: tech@ebu.ch.