Skip to main content
All requests to the GraphQL endpoint require a valid API key.

Passing your API key

Provide the key via either of these methods:
curl -X POST https://api.definitiv.io/graphql \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_your_api_key_here" \
  -d '{"query": "{ ... }"}'

Key format

API keys are prefixed with pk_ followed by a 64-character hex string:
pk_a1b2c3d4e5f6...
Your API key is shown once when generated. Store it securely — lost keys cannot be recovered.

Error responses

Missing or invalid keys return HTTP 401:
{
  "errors": [
    {
      "message": "Missing API key. Provide via x-api-key header or Authorization: Bearer <key>."
    }
  ]
}