This guide walks you through the steps to make your first DQE API call — from obtaining credentials to calling a service endpoint.
Prerequisites
- A valid DQE licence code and client secret (provided by DQE)
- An HTTP client or your own application code
Step 1 — Authenticate with OAuth2
DQE APIs use OAuth2 Bearer token authentication. Before calling any service, request a token:
- Call the OAuth2 endpoint with your licence code, client secret, and the scope of the service you want to access.
- Read the access token returned in the JSON response.
- Include it as a
Bearertoken in theAuthorizationheader of your API requests.
Tokens are valid for a limited period — generate a new one before it expires.
See full OAuth2 documentation →
Step 2 — Call a service endpoint
DQE APIs support both GET and POST methods. Responses are always returned in JSON format.
For some services, the country parameter is mandatory and must use the ISO 3166-1 alpha-3 country code (e.g. FRA for France, GBR for the United Kingdom).
Step 3 — Test the API interactively
Many DQE API articles include a live "Test the API" console that lets you explore and test endpoints directly in your browser, without writing any code — the fastest way to understand request parameters and response formats before starting your integration.
An interactive console, along with ready-to-use code examples in several languages, is available within each supported API endpoint article. Browse all API endpoints →
Important notes
- DQE APIs are designed for real-time, single-record calls. Do not use them for batch processing — use file-based batch processing for bulk operations.
- Implementing API calls in blocking mode is at the client's sole responsibility. DQE recommends thorough testing before production deployment.
Related articles
Related to