Preview managed-case routing.
POST/managed-cases/preview
Optional, read-only snapshot. HasPreLegalPartner describes a routing candidate, not permission to create a case. No match may lead to internal review and potentially network quotes on submission; neither acceptance nor a quote is guaranteed. Full validation, agreements and admission rules still apply on creation. No client, case or routing reservation is created by this endpoint. Send outstanding principal, currency and debtor type/country/state; invoice lines and pricing inputs are not evaluated. Model-binding errors use ValidationProblemDetails.
marketMinimumAmount is the smallest claim the market takes for this debtor country and type (never
below the platform minimum of 100 USD). applicableMinimumAmount is not populated by this endpoint.
Examples
Matched — request {"amountToRecover": 15000, "currencyCode": "USD", "debtor": {"type": "Company", "countryAlpha2": "US", "stateAlpha2": "NY"}}
→ response {"hasPreLegalPartner": true, "collectionPartnerId": "...", "routingSource": "Automatic", "marketMinimumAmount": 500, "marketMinimumCurrencyCode": "USD"}.
No match, amount below minimum — request {"amountToRecover": 175, "currencyCode": "USD", "debtor": {"type": "Company", "countryAlpha2": "US", "stateAlpha2": "NY"}}
→ response {"hasPreLegalPartner": false, "ineligibilityReasonCode": "AmountBelowMinimum", "marketMinimumAmount": 500, "marketMinimumCurrencyCode": "USD"}.
No match, no geographic coverage — request {"amountToRecover": 2000, "currencyCode": "USD", "debtor": {"type": "Company", "countryAlpha2": "VN"}}
→ response {"hasPreLegalPartner": false, "ineligibilityReasonCode": "NoGeographicCoverage", "marketMinimumAmount": null}.
Excluded for this client — request with a clientId excluded from every remaining candidate
→ response {"hasPreLegalPartner": false, "ineligibilityReasonCode": "ExcludedForClient"}.
Explicit override — request {"amountToRecover": 2000, "currencyCode": "USD", "collectionPartnerId": "(a partner id)", "debtor": {...}}
→ response {"hasPreLegalPartner": true, "collectionPartnerId": "(the same id)", "routingSource": "Requested"}.
Degraded FX — an unquotable request currency still returns a selected candidate where one exists:
response {"hasPreLegalPartner": true, "routingSource": "Automatic", "ineligibilityReasonCode": "EligibilityUndetermined", "amountCheckUnavailable": true, "marketMinimumAmount": null}.
Request
Responses
- 200
- 400
- 401
- 404
- 500
OK
Bad Request
Unauthorized
Not Found
Internal Server Error