Skip to main content

Quickstart

Onboard your first client and submit a case in 5 minutes.

Prerequisites​

Get your API key from your Debitura partnership manager. See Authentication for the two-layer auth model.

1. Create a Client​

curl -X POST https://testreferral-api.debitura.com/clients \
  -H "Content-Type: application/json" \
  -H "XApiKey: YOUR_API_KEY" \
  -d '{
    "companyName": "Test Client Company",
    "countryAlpha2": "DE",
    "email": "test@example.com"
  }'

Response: New Client (202)​

{
  "creditorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "PendingOnboarding",
  "onboardingUrl": "https://referral.debitura.com/onboard/abc123"
}

Redirect your user to the onboardingUrl to complete signup and SDCA signing.

2. Generate a Bearer Token​

After the client completes onboarding:

curl -X POST https://testreferral-api.debitura.com/access-tokens \
  -H "Content-Type: application/json" \
  -H "XApiKey: YOUR_API_KEY" \
  -d '{
    "creditorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }'
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "expiresAt": "2025-01-15T12:30:00Z"
}

3. Submit a Case​

Use the bearer token with the Customer API:

curl -X POST https://customer-api.debitura.com/cases \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -d '{
    "isTest": true,
    "currencyCode": "EUR",
    "date": "2025-01-15",
    "amountToRecover": 1000.00,
    "debtor": {
      "type": "Company",
      "name": "Test Debtor",
      "address": "Test Street 1",
      "city": "Berlin",
      "countryAlpha2": "DE"
    }
  }'

The case is automatically attributed to your partnership for revenue tracking.

Next Steps​