Skip to main content

Preview case pricing

POST 
/cases/preview

Preview the success fee pricing for a potential case without creating it.

What This Endpoint Returns:

  • IsEligible - Whether the case can be submitted (partner available in this jurisdiction)
  • PricingPreview - Estimated success fee with base rate and any age-based surcharges
  • Jurisdiction - Geographic details for the matched jurisdiction

Use This To:

  1. Show your clients the Debitura success fee before they onboard
  2. Check if a jurisdiction is supported before starting the onboarding flow
  3. Display age-adjusted pricing for aged debt portfolios

Required Fields:

  • AmountToRecover - Total principal amount
  • CurrencyCode - ISO 4217 currency code (e.g., 'GBP', 'EUR', 'USD')
  • Debtor.Type - 'Company' or 'Private'
  • Debtor.CountryAlpha2 - ISO 3166-1 alpha-2 country code
  • Debtor.StateAlpha2 - Required for US cases only (e.g., 'CA', 'NY')

Age-Based Pricing (Optional)

Single invoice — pass dueDate: The simplest way to get age-adjusted pricing. Provide the invoice due date (ISO 8601, e.g. 2024-01-15) and Debitura computes the age surcharge internally. Cannot be a future date. Mutually exclusive with age bucket fields.

Multi-invoice portfolio — pass age buckets: For portfolios with invoices at different ages, pass the portion of the total that falls into each age bracket:

  • AmountToRecoverOver12Months and AmountToRecoverOver24Months must be provided together
  • AmountToRecoverOver6Months is optional but improves pricing tier accuracy at the 180-day threshold; can only be provided alongside the 12/24-month fields, must be >= AmountToRecoverOver12Months, and must be < AmountToRecover

Multi-invoice portfolio — pass claimLines instead (recommended): Send the unpaid invoices and let Debitura do the arithmetic:

"claimLines": [
  { "dueDate": "2024-01-15", "amount": 423.42, "reference": "INV-1001" },
  { "dueDate": "2025-05-02", "amount": 700.87, "reference": "INV-1042" }
]
  • amount is the outstanding balance on that invoice, already net of payments and credit notes — not its original face value.
  • Debitura derives amountToRecover and all three age buckets from the lines and prices on them, so send claimLines instead of amountToRecover, the age bucket fields, and dueDate. Combining any of those with claimLines is a 400.
  • Use claimLines whenever the debtor has already part-paid: it is the only way to express an honest age profile on a part-paid claim, because the buckets are computed on the same outstanding balances the total is.
  • Maximum 1000 lines. Per-line errors are returned keyed by index, e.g. ClaimLines[2].DueDate.
  • The same ledger produces the same derived total and buckets on POST /clients case submission.

dueDate, the age bucket fields and claimLines are mutually exclusive — use one of the three. When no age fields are provided, base pricing is returned without age surcharge.

Important Notes:

  • This endpoint does NOT create a case — it only previews pricing
  • Pricing is based on the referral partner's agreed rate (jurisdiction pricing zone rate if applicable)
  • No creditor or client account is needed

Request​

Responses​

Preview completed