# Case Management API

- [Welcome](https://documentation.incaseof.law/Welcome.md)
- [Quick Start Guide](https://documentation.incaseof.law/Quick-Start-Guide.md)
- [Partner & Revenue Share Workflow](https://documentation.incaseof.law/Partner-Workflow.md): Set up commission-based partnerships and track revenue shares automatically
- [Partner sandbox](https://documentation.incaseof.law/Partner-Sandbox.md): Build and test your integration against the same API as production — nothing reaches a real person.
- [Webhooks Overview](https://documentation.incaseof.law/webhooks/overview.md): Receive signed HTTP POSTs whenever a claim's collection stage or case status changes.
- [Collection Stage Events](https://documentation.incaseof.law/webhooks/claim-collection-stage-changed.md): Fired whenever a claim moves to a new collection stage.
- [Case Status Events](https://documentation.incaseof.law/webhooks/claim-status-changed.md): Fired when a claim is closed (with the reason), disputed or reopened.
- [Create claim](https://documentation.incaseof.law/api-reference/claims/create-claim.md): Requires API token authentication. Create a new claim. The organization is determined from your API token. Financial, workflow and collection stage fields are managed automatically by the system and **cannot** be set from this endpoint.
- [List claims](https://documentation.incaseof.law/api-reference/claims/list-claims.md): List claims with optional filters (debtor, status, date range)
- [Get claim details](https://documentation.incaseof.law/api-reference/claims/get-claim.md): Get detailed claim information including nested invoices
- [Update claim](https://documentation.incaseof.law/api-reference/claims/update-claim.md): Update the dispute / fulfilment flags of a claim, or relink it to a customer for partner revenue sharing. All fields are optional — only send the fields you want to update.
- [Estimate the judicial step](https://documentation.incaseof.law/api-reference/claims/estimate-lawsuit-decision.md): What taking the claim to court would cost, and which rules a decision will be checked against. Call it when a claim reaches `dunning_action_recommended` (the webhook tells you) and before you send a decision.
- [Decide on the judicial step](https://documentation.incaseof.law/api-reference/claims/create-lawsuit-decision.md): The creditor's decision at `dunning_action_recommended`: `sue` takes the claim to court (a Mahnbescheid in Germany, a Mahnklage in Austria), `decline` does not. One decision per claim — a second one answers `400`.
- [Get the judicial-step decision](https://documentation.incaseof.law/api-reference/claims/get-lawsuit-decision.md): The decision taken on this claim — through the API or by the creditor in the portal. `404` while none exists.
- [Create debtor](https://documentation.incaseof.law/api-reference/debtors/create-debtor.md): Create a new debtor. The organization_id is automatically derived from your API token.
- [List debtors](https://documentation.incaseof.law/api-reference/debtors/list-debtors.md): List and filter debtors
- [Get debtor details](https://documentation.incaseof.law/api-reference/debtors/get-debtor.md): Get detailed debtor information
- [Update debtor](https://documentation.incaseof.law/api-reference/debtors/update-debtor.md): Update debtor information. All fields are optional - only send the fields you want to update.
- [Create customer (or reuse the existing one)](https://documentation.incaseof.law/api-reference/customers/create-customer.md): Create a new customer linked to a partner. Requires a valid partner_id. The organization is determined from your API token. The partner must belong to the same organization as the API token.
- [List customers](https://documentation.incaseof.law/api-reference/customers/list-customers.md): List customers for the organization. Optionally filter by partner_id. Only returns customers belonging to the API token's organization.
- [Get customer by ID](https://documentation.incaseof.law/api-reference/customers/get-customer.md): Get customer details. Returns 404 if the customer does not belong to the API token's organization.
- [Update customer](https://documentation.incaseof.law/api-reference/customers/update-customer.md): Update customer information. All fields are optional. If partner_id is changed, the new partner must belong to the same organization. Use it to add `partner_client_reference` / `uid` to a customer created without them; `null` clears a key. A key already held by another customer of your partner accou…
- [Delete customer](https://documentation.incaseof.law/api-reference/customers/delete-customer.md): Delete a customer. The customer must belong to the API token's organization.
- [Upload invoice PDF to claim](https://documentation.incaseof.law/api-reference/invoices/create-invoice.md): Upload a PDF invoice and attach it to a claim. The invoice amount will automatically  update the claim's total_claim_amount via database triggers.
- [Create invoice manually (JSON, no PDF)](https://documentation.incaseof.law/api-reference/invoices/create-invoice-manual.md): Create an invoice by submitting the invoice data as structured JSON, without uploading a PDF document. Use this when you have no invoice file and want to pass all fields manually.
- [List invoices for claim](https://documentation.incaseof.law/api-reference/invoices/list-invoices.md): Get all invoices attached to a specific claim
- [Record payment](https://documentation.incaseof.law/api-reference/payments/create-payment.md): Record a payment against a claim. The payment will automatically update the claim's paid and outstanding amounts.
- [List payments for claim](https://documentation.incaseof.law/api-reference/payments/list-payments.md): Get all payments for a specific claim
- [Get payment by ID](https://documentation.incaseof.law/api-reference/payments/get-payment.md): Retrieve details of a single payment
- [Upload Document](https://documentation.incaseof.law/api-reference/documents/upload-document.md): Upload additional supporting documents to a claim (PDF, Word, Excel, XML, images, etc.)
- [List Documents](https://documentation.incaseof.law/api-reference/documents/list-documents.md): Get all documents attached to a specific claim
- [Download Document](https://documentation.incaseof.law/api-reference/documents/download-document.md): Download the actual document file
- [Delete Document](https://documentation.incaseof.law/api-reference/documents/delete-document.md): Delete a document you uploaded through the API

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.