Coverage & Eligibility#

Check which jurisdictions CasaPay's debt collection network covers and whether a specific case is eligible for collection.

The Coverage object#

Attribute	Type	Description
`country`	string	ISO 3166-1 alpha-2 country code
`country_name`	string	Country display name
`debtor_types`	array	Supported debtor types: `private`, `company`
`available_partners`	integer	Number of partners available
`min_amount`	integer	Minimum recoverable amount
`max_amount`	integer	Maximum recoverable amount
`currency`	string	Default currency
`avg_success_fee_pct`	number	Average success fee percentage
`status`	enum	`available`, `limited`, `unavailable`

{
  "country": "DE",
  "country_name": "Germany",
  "debtor_types": ["private", "company"],
  "available_partners": 3,
  "min_amount": 5000,
  "max_amount": 50000000,
  "currency": "eur",
  "avg_success_fee_pct": 14.5,
  "status": "available"
}

List All Coverage#

GET /v1/collection_coverage

curl https://api.casapay.com/v1/collection_coverage \
  -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc"

{
  "object": "list",
  "data": [
    { "country": "DE", "country_name": "Germany", "status": "available", "debtor_types": ["private", "company"] },
    { "country": "GB", "country_name": "United Kingdom", "status": "available", "debtor_types": ["private", "company"] },
    { "country": "FR", "country_name": "France", "status": "available", "debtor_types": ["private", "company"] },
    { "country": "NL", "country_name": "Netherlands", "status": "available", "debtor_types": ["private", "company"] },
    { "country": "ES", "country_name": "Spain", "status": "limited", "debtor_types": ["company"] },
    { "country": "IT", "country_name": "Italy", "status": "available", "debtor_types": ["private", "company"] }
  ]
}

Get Coverage by Jurisdiction#

GET /v1/collection_coverage/:country

curl https://api.casapay.com/v1/collection_coverage/DE \
  -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc"

Check Eligibility#

Check if a specific debt is eligible for collection. This is a simplified version of the Case Preview endpoint.

POST /v1/collection_coverage/check

Parameter	Type	Required	Description
`country`	string	Yes	Debtor's country
`debtor_type`	string	Yes	`private` or `company`
`amount`	integer	Yes	Debt amount
`currency`	string	Yes	Currency code

curl https://api.casapay.com/v1/collection_coverage/check \
  -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "DE",
    "debtor_type": "private",
    "amount": 360000,
    "currency": "eur"
  }'

{
  "eligible": true,
  "country": "DE",
  "debtor_type": "private",
  "estimated_fee_pct": 14.5,
  "partners_available": 3
}