Coverage

Jurisdiction coverage — query which countries and debt types Debitura can collect in, and check case eligibility.

Base URL: https://customer-api.debitura.com
Authentication: API key in the XApiKey header

List all jurisdiction coverage

GET/coverage

Returns complete coverage information for all jurisdictions where Debitura operates, including power of attorney signing status and solution URLs.

Returns

200 Coverage list returned — a list of the objects below.

jurisdictionstringnullable
jurisdictionIdinteger
countrystringnullable
countryIdinteger
countryAlpha2stringnullable
usStateAlpha2stringnullable
partnersarray of objectsnullable
Collection partners available for this jurisdiction. May be empty if no partners are assigned. May contain multiple partners if different conditions apply (e.g., B2B vs B2C).

GET/coverage

curl https://customer-api.debitura.com/coverage \
  -H "XApiKey: $DEBITURA_API_KEY"

Response

[
  {
    "jurisdiction": "string",
    "jurisdictionId": 3,
    "country": "Germany",
    "countryId": 42,
    "countryAlpha2": "DE",
    "usStateAlpha2": null,
    "partners": [
      {
        "partnerId": "3f2b6c1e-8a4d-4b7f-9c2e-5d1a0b9e7f31",
        "partnerName": "Muster GmbH",
        "conditions": "string",
        "signed": true,
        "termsUrl": "https://app.debitura.com/…",
        "solutionUrl": "https://app.debitura.com/…",
        "requiresResigning": true,
        "invalidationReason": null
      }
    ]
  }
]

Get jurisdiction coverage by ID

GET/coverage/{id}

Returns a single jurisdiction with its geographic information, assigned collection partner, and power of attorney signing status.

Path parameters

idintegerRequired

Returns

200 Coverage item returned

jurisdictionstringnullable
jurisdictionIdinteger
countrystringnullable
countryIdinteger
countryAlpha2stringnullable
usStateAlpha2stringnullable
partnersarray of objectsnullable
Collection partners available for this jurisdiction. May be empty if no partners are assigned. May contain multiple partners if different conditions apply (e.g., B2B vs B2C).

Errors

404 Jurisdiction not found

See Error handling.

GET/coverage/{id}

curl https://customer-api.debitura.com/coverage/3 \
  -H "XApiKey: $DEBITURA_API_KEY"

Response

{
  "jurisdiction": "string",
  "jurisdictionId": 3,
  "country": "Germany",
  "countryId": 42,
  "countryAlpha2": "DE",
  "usStateAlpha2": null,
  "partners": [
    {
      "partnerId": "3f2b6c1e-8a4d-4b7f-9c2e-5d1a0b9e7f31",
      "partnerName": "Muster GmbH",
      "conditions": "string",
      "signed": true,
      "termsUrl": "https://app.debitura.com/…",
      "solutionUrl": "https://app.debitura.com/…",
      "requiresResigning": true,
      "invalidationReason": null
    }
  ]
}

Check case eligibility and get assigned partner

POST/coverage/check-eligibility

Determine if a case can be submitted and get partner + PoA status.

Request Fields:

CountryAlpha2 (required) - Debtor country (e.g., 'DK', 'US', 'DE')
StateAlpha2 (conditional) - Required for US debtors (e.g., 'CA', 'NY')
DebtorType (required) - 'Company' or 'Private'
Amount (required) - Amount to recover
CurrencyCode (required) - Currency (e.g., 'USD', 'EUR', 'DKK')

Response:

IsEligible (boolean) - Whether case can be submitted
Partner - Specific partner that will handle this case
PowerOfAttorneyStatus - PoA signing status for the matched partner

Note: Does NOT check SDCA status. Use GET /contracts/debt-collection/status for that.

Request body

countryAlpha2stringRequired
Debtor country (2-letter ISO code, e.g., "DK", "US", "DE")
stateAlpha2stringnullable
US state code for US debtors (e.g., "CA", "NY"). Required if CountryAlpha2 = "US"
debtorTypestringRequired
Debtor type: "Company" or "Private"
amountnumberRequired
Amount to recover in specified currency
Min 0.01
currencyCodestringRequired
Currency code (e.g., "USD", "EUR", "DKK")

Returns

200 Eligibility check completed

isEligibleboolean
Whether a collection partner is available for this case
jurisdictionobject
Jurisdiction information
partnerobject
Partner information
powerOfAttorneyStatusobject
Power of Attorney status (shared DTO for check-eligibility and coverage endpoints).
errorMessagestringnullable
Error message if IsEligible = false. Branch on IneligibilityReasonCode rather than on this text, which may be reworded.
ineligibilityReasonCodestringnullable
Stable machine-readable reason, present whenever ErrorMessage is. One of: NoGeographicCoverage, AmountBelowMinimum, AmountAboveMaximum, DebtorTypeNotCovered, NotCoveredByPartnerRules, ExcludedForClient, EligibilityUndetermined.

Only NoGeographicCoverage means we have no partner in the jurisdiction. AmountBelowMinimum means the geography IS covered and only the claim amount fell short. EligibilityUndetermined is a transient failure on our side, not a statement about coverage.
applicableMinimumAmountnumbernullable
What this claim would have to reach to be accepted, in the currency of the request; never below the platform minimum of 100 USD. Only present when no partner was matched. Withheld when the client's own routing exclusions mean the number would not be reachable for them, and when the request currency cannot be priced. Null when no partner covering this case declares a minimum.
applicableMinimumCurrencyCodestringnullable
ISO code that ApplicableMinimumAmount is expressed in.
marketMinimumAmountnumbernullable
The smallest claim the marketplace takes for this jurisdiction and debtor type, in the currency of the request: the lowest partner floor, never below the platform minimum of 100 USD. A statement about the market, not about this claim: it is returned whether or not a partner was selected, and does not depend on the claim amount or on the caller. It is not the admission rules applied when a case is created. Null when no partner covers the market or the amount cannot be priced.
marketMinimumCurrencyCodestringnullable
ISO code that MarketMinimumAmount is expressed in.
amountCheckUnavailableboolean
True when a currency conversion needed to evaluate the claim amount was unavailable, so the amount-based part of this answer was NOT actually checked It can be true on an eligible answer: a partner matched only because amount conditions failed open while rates were down. Treat such an answer as provisional and retry rather than relying on the floor having been applied.

Errors

400 Invalid request (validation errors)

See Error handling.

POST/coverage/check-eligibility

curl -X POST https://customer-api.debitura.com/coverage/check-eligibility \
  -H "XApiKey: $DEBITURA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countryAlpha2": "PL",
    "debtorType": "Company",
    "amount": 2500,
    "currencyCode": "EUR"
  }'

Response

{
  "isEligible": true,
  "jurisdiction": {
    "id": 3,
    "name": "Muster GmbH",
    "country": "Germany",
    "countryAlpha2": "DE",
    "usStateAlpha2": null
  },
  "partner": {
    "id": "3f2b6c1e-8a4d-4b7f-9c2e-5d1a0b9e7f31",
    "name": "Muster GmbH"
  },
  "powerOfAttorneyStatus": {
    "signed": true,
    "requiresResigning": true,
    "invalidationReason": null,
    "termsUrl": "https://app.debitura.com/…",
    "solutionUrl": "https://app.debitura.com/…"
  },
  "errorMessage": null,
  "ineligibilityReasonCode": null,
  "applicableMinimumAmount": 2500,
  "applicableMinimumCurrencyCode": "EUR",
  "marketMinimumAmount": 2500,
  "marketMinimumCurrencyCode": "EUR",
  "amountCheckUnavailable": true
}

Deprecated

Kept working for existing integrations. Do not build on these.

Search for jurisdiction coverageDeprecated

GET/coverage/search

⚠️ DEPRECATED: Use POST /coverage/check-eligibility instead.

Query parameters

qstring

Returns

200 Coverage item returned

jurisdictionstringnullable
jurisdictionIdinteger
countrystringnullable
countryIdinteger
countryAlpha2stringnullable
usStateAlpha2stringnullable
partnersarray of objectsnullable
Collection partners available for this jurisdiction. May be empty if no partners are assigned. May contain multiple partners if different conditions apply (e.g., B2B vs B2C).

Errors

`400`	Search query missing or invalid
`404`	No jurisdiction found matching the search query

See Error handling.

GET/coverage/search

curl https://customer-api.debitura.com/coverage/search \
  -H "XApiKey: $DEBITURA_API_KEY"

Response

{
  "jurisdiction": "string",
  "jurisdictionId": 3,
  "country": "Germany",
  "countryId": 42,
  "countryAlpha2": "DE",
  "usStateAlpha2": null,
  "partners": [
    {
      "partnerId": "3f2b6c1e-8a4d-4b7f-9c2e-5d1a0b9e7f31",
      "partnerName": "Muster GmbH",
      "conditions": "string",
      "signed": true,
      "termsUrl": "https://app.debitura.com/…",
      "solutionUrl": "https://app.debitura.com/…",
      "requiresResigning": true,
      "invalidationReason": null
    }
  ]
}

Search for jurisdiction coverageDeprecated

GET/coverage/:search

⚠️ DEPRECATED: Use POST /coverage/check-eligibility instead.

Query parameters

qstring

Returns

200 Coverage item returned

jurisdictionstringnullable
jurisdictionIdinteger
countrystringnullable
countryIdinteger
countryAlpha2stringnullable
usStateAlpha2stringnullable
partnersarray of objectsnullable
Collection partners available for this jurisdiction. May be empty if no partners are assigned. May contain multiple partners if different conditions apply (e.g., B2B vs B2C).

Errors

`400`	Search query missing or invalid
`404`	No jurisdiction found matching the search query

See Error handling.

GET/coverage/:search

curl https://customer-api.debitura.com/coverage/:search \
  -H "XApiKey: $DEBITURA_API_KEY"

Response

{
  "jurisdiction": "string",
  "jurisdictionId": 3,
  "country": "Germany",
  "countryId": 42,
  "countryAlpha2": "DE",
  "usStateAlpha2": null,
  "partners": [
    {
      "partnerId": "3f2b6c1e-8a4d-4b7f-9c2e-5d1a0b9e7f31",
      "partnerName": "Muster GmbH",
      "conditions": "string",
      "signed": true,
      "termsUrl": "https://app.debitura.com/…",
      "solutionUrl": "https://app.debitura.com/…",
      "requiresResigning": true,
      "invalidationReason": null
    }
  ]
}