KINETIC
APIDOCS
KINETIC APIProtocol · API reference
MD-Version 2026-06-11 Request access

● Case spine

Claimants

Claimant registry and recovery economics.

POST/v1/matters/{matter_id}/claimantsAdd claimant
GET/v1/matters/{matter_id}/claimantsList claimants
GET/v1/claimants/{claimant_id}Get claimant
PATCH/v1/claimants/{claimant_id}Update claimant
POST/v1/matters/{matter_id}/claimants

Add claimant

Adds claimant, creditor, assignee, or recovery interest holder to a matter.

scope · claimants:writeidempotent · Idempotency-Key
§ Path parameters
ParameterType
matter_id
required · path
string
§ Body parameters
FieldType
namestring
rolestring
economicsobject
source_refsarray
# sandbox: full surface, no production data
curl -X POST https://sandbox.api.microndelta.com/v1/matters/mtr_4Fa1/claimants \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f8a-bd31" \
  -d '{
  "name": "string",
  "role": "string",
  "economics": {},
  "source_refs": [
    {
      "source_id": "...",
      "source_type": "...",
      "title": "...",
      "uri": "...",
      "hash": "...",
      "chain_of_custody_id": "...",
      "admissibility_notes": "..."
    }
  ]
}'
import requests

resp = requests.post(
    "https://sandbox.api.microndelta.com/v1/matters/mtr_4Fa1/claimants",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
        "Idempotency-Key": "4f8a-bd31",
    },
    json={
        "name": "string",
        "role": "string",
        "economics": {},
        "source_refs": [
            {
                "source_id": "...",
                "source_type": "...",
                "title": "...",
                "uri": "...",
                "hash": "...",
                "chain_of_custody_id": "...",
                "admissibility_notes": "..."
            }
        ]
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/matters/mtr_4Fa1/claimants", {
  method: "POST",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
    "Content-Type": "application/json",
    "Idempotency-Key": "4f8a-bd31",
  },
  body: JSON.stringify({
    "name": "string",
    "role": "string",
    "economics": {},
    "source_refs": [
      {
        "source_id": "...",
        "source_type": "...",
        "title": "...",
        "uri": "...",
        "hash": "...",
        "chain_of_custody_id": "...",
        "admissibility_notes": "..."
      }
    ]
  }),
});
console.log(await resp.json());
● 200MD-Request-Id: req_01J…
201 Response
{
  "claimant_id": "string",
  "matter_id": "string",
  "name": "string",
  "role": "creditor",
  "economics": {},
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
GET/v1/matters/{matter_id}/claimants

List claimants

Lists matter claimants and recovery economics.

scope · claimants:read
§ Path parameters
ParameterType
matter_id
required · path
string
# sandbox: full surface, no production data
curl https://sandbox.api.microndelta.com/v1/matters/mtr_4Fa1/claimants \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11"
import requests

resp = requests.get(
    "https://sandbox.api.microndelta.com/v1/matters/mtr_4Fa1/claimants",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/matters/mtr_4Fa1/claimants", {
  method: "GET",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
  },
});
console.log(await resp.json());
● 200MD-Request-Id: req_01J…
200 Response
{
  "object": "list",
  "data": [
    {
      "claimant_id": "...",
      "matter_id": "...",
      "name": "...",
      "role": "...",
      "economics": "...",
      "review_state": "..."
    }
  ],
  "has_more": false
}
GET/v1/claimants/{claimant_id}

Get claimant

Gets claimant and economics terms.

scope · claimants:read
§ Path parameters
ParameterType
claimant_id
required · path
string
# sandbox: full surface, no production data
curl https://sandbox.api.microndelta.com/v1/claimants/cla_91Lk \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11"
import requests

resp = requests.get(
    "https://sandbox.api.microndelta.com/v1/claimants/cla_91Lk",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/claimants/cla_91Lk", {
  method: "GET",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
  },
});
console.log(await resp.json());
● 200MD-Request-Id: req_01J…
200 Response
{
  "claimant_id": "string",
  "matter_id": "string",
  "name": "string",
  "role": "creditor",
  "economics": {},
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
PATCH/v1/claimants/{claimant_id}

Update claimant

Updates claimant terms and review status.

scope · claimants:writeidempotent · Idempotency-Key
§ Path parameters
ParameterType
claimant_id
required · path
string
§ Body parameters
FieldType
namestring
economicsobject
review_stateobject
# sandbox: full surface, no production data
curl -X PATCH https://sandbox.api.microndelta.com/v1/claimants/cla_91Lk \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f8a-bd31" \
  -d '{
  "name": "string",
  "economics": {},
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}'
import requests

resp = requests.patch(
    "https://sandbox.api.microndelta.com/v1/claimants/cla_91Lk",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
        "Idempotency-Key": "4f8a-bd31",
    },
    json={
        "name": "string",
        "economics": {},
        "review_state": {
            "review_required": True,
            "review_status": "not_required",
            "review_owner": "string",
            "review_notes": "string"
        }
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/claimants/cla_91Lk", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
    "Content-Type": "application/json",
    "Idempotency-Key": "4f8a-bd31",
  },
  body: JSON.stringify({
    "name": "string",
    "economics": {},
    "review_state": {
      "review_required": true,
      "review_status": "not_required",
      "review_owner": "string",
      "review_notes": "string"
    }
  }),
});
console.log(await resp.json());
● 200MD-Request-Id: req_01J…
200 Response
{
  "claimant_id": "string",
  "matter_id": "string",
  "name": "string",
  "role": "creditor",
  "economics": {},
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
© Kinetic API · Claimants · 4 operationsMD-Version 2026-06-11