curl --request PATCH \
  --url https://service.incaseof.law/openapi/claims/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "claim_disputed": true,
  "obligation_fulfilled": false
}
'

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "debtor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "case_reference": "<string>",
    "status": "open",
    "collection_stage": "new",
    "subject_matter": "<string>",
    "main_claim_currency": "EUR",
    "total_claim_amount": 123,
    "total_claim_currency": "EUR",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Claims

Update claim

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.

State is read-only on the public API. The lifecycle state of a claim — collection_stage, submission_state and status — is driven by the internal collection workflow and cannot be changed by API customers. Sending any of those fields returns 400 Validation failed.

Financial and metadata fields are not writable via the public API. To manage invoices, use the nested invoice endpoints:

POST /openapi/claims/:claim_id/invoices
GET /openapi/claims/:claim_id/invoices

PATCH

openapi

claims

{id}

curl --request PATCH \
  --url https://service.incaseof.law/openapi/claims/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "claim_disputed": true,
  "obligation_fulfilled": false
}
'

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "debtor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "case_reference": "<string>",
    "status": "open",
    "collection_stage": "new",
    "subject_matter": "<string>",
    "main_claim_currency": "EUR",
    "total_claim_amount": 123,
    "total_claim_currency": "EUR",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<uuid>

required

UUID of the claim to update

Body

application/json

claim_disputed

boolean

Mark claim as disputed

obligation_fulfilled

boolean

Mark obligation as fulfilled

customer_id

string<uuid> | null

Optional link to a customer for partner revenue sharing

Response

Claim updated

success

boolean

data

object

Show child attributes

Getting Started

API Reference

Update claim

Authorizations

Path Parameters

Body

Response