Skip to content
Dimarc Documentation

Retrieving Your Authentication Token

To use the DIMARC API, you must authenticate using a token in each of your calls. This guide explains how to obtain and use this authentication token.

Prerequisites

  • An active DIMARC account.

Getting your API keys

To use our services via API, you will need an API key:

  1. In your dashboard, click on your profile icon in the top right corner, then go to the Organization > API section
  2. In the API Keys section, you can retrieve your ClientId and ClientSecret

Retrieving Your Authentication Token

GET /v2/token

Once you have your ClientId and ClientSecret, you can generate an authentication token by following these steps:

  1. Make a GET request to our authentication endpoint https://api.dimarc.ai/v2/token with your credentials as query parameters
  2. Retrieve the returned JWT token

Request

Fenêtre de terminal
curl --location 'https://api.dimarc.ai/v2/token?client_id=your-client-id&client_secret=your-client-secret'

Response

{
    "access_token": "**************",
    "token_type": "x-api-key",
    "expires_in": "3600"
}

Using the authentication token

To use the authentication token in your API requests, include it in the x-api-key header of the request:

Fenêtre de terminal
curl --request GET \
  --url https://api.dimarc.ai/v2/endpoint \
  --header 'x-api-key: **************'

Troubleshooting

If you encounter authentication problems, check the following points:

  1. Your credentials (ClientId and ClientSecret) are correctly entered
  2. Your token is not expired
  3. Your account has the necessary permissions for the requested operation

For additional assistance, contact our technical support at: support@dimarc.fr