Skip to main content

Authentication

Authenticate with the Customer API using an API key in the XApiKey header. The key grants full access to all endpoints for your client account.

Getting Your API Key​

Generate keys in the Creditor Portal → API Keys. You can create multiple keys (e.g., for different systems or team members).

Making Requests​

Include your API key in every request:

curl https://customer-api.debitura.com/me \
  -H "XApiKey: YOUR_API_KEY"

A successful response confirms your key is valid:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "companyName": "Acme Corporation",
  "companyRegistrationNumber": "12345678",
  "country": "DK",
  "officeEmail": "billing@acme.com"
}

For authentication errors (401), see Error Handling.

See Environments for base URLs and test mode, or continue to the Quickstart to create your first case.