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

Case spine

Debtors

Debtor/adversary profiles, graphs, and asset hypotheses.

POST/v1/debtorsCreate debtor/adversary
GET/v1/debtorsList debtors
GET/v1/debtors/{debtor_id}Get debtor/adversary
PATCH/v1/debtors/{debtor_id}Update debtor/adversary
POST/v1/debtors/{debtor_id}/graphBuild debtor graph
POST/v1/debtors/{debtor_id}/asset-hypothesesCreate asset hypotheses
POST/v1/debtors

Create debtor/adversary

Creates a debtor, adversary, nominee, entity, or related enforcement subject.

scope · debtors:writeidempotent · Idempotency-Key
§ Body parameters
FieldType
matter_idstring
typestring
legal_namestring
aliasesarray
identifiersobject
# sandbox: full surface, no production data
curl -X POST https://sandbox.api.microndelta.com/v1/debtors \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f8a-bd31" \
  -d '{
  "matter_id": "string",
  "type": "string",
  "legal_name": "string",
  "aliases": [
    "string"
  ],
  "identifiers": {}
}'
import requests

resp = requests.post(
    "https://sandbox.api.microndelta.com/v1/debtors",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
        "Idempotency-Key": "4f8a-bd31",
    },
    json={
        "matter_id": "string",
        "type": "string",
        "legal_name": "string",
        "aliases": [
            "string"
        ],
        "identifiers": {}
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/debtors", {
  method: "POST",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
    "Content-Type": "application/json",
    "Idempotency-Key": "4f8a-bd31",
  },
  body: JSON.stringify({
    "matter_id": "string",
    "type": "string",
    "legal_name": "string",
    "aliases": [
      "string"
    ],
    "identifiers": {}
  }),
});
console.log(await resp.json());
● 200MD-Request-Id: req_01J…
201 Response
{
  "debtor_id": "string",
  "matter_id": "string",
  "type": "individual",
  "legal_name": "string",
  "aliases": [
    "string"
  ],
  "identifiers": {},
  "wallets": [
    "string"
  ],
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
GET/v1/debtors

List debtors

Lists debtors/adversaries available to the caller.

scope · debtors:read
# sandbox: full surface, no production data
curl https://sandbox.api.microndelta.com/v1/debtors \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11"
import requests

resp = requests.get(
    "https://sandbox.api.microndelta.com/v1/debtors",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/debtors", {
  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": [
    {
      "debtor_id": "...",
      "matter_id": "...",
      "type": "...",
      "legal_name": "...",
      "aliases": "...",
      "identifiers": "...",
      "wallets": "...",
      "review_state": "..."
    }
  ],
  "has_more": false
}
GET/v1/debtors/{debtor_id}

Get debtor/adversary

Gets profile, aliases, wallets, assets, and review status.

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

resp = requests.get(
    "https://sandbox.api.microndelta.com/v1/debtors/deb_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/debtors/deb_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
{
  "debtor_id": "string",
  "matter_id": "string",
  "type": "individual",
  "legal_name": "string",
  "aliases": [
    "string"
  ],
  "identifiers": {},
  "wallets": [
    "string"
  ],
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
PATCH/v1/debtors/{debtor_id}

Update debtor/adversary

Updates profile and linked identifiers.

scope · debtors:writeidempotent · Idempotency-Key
§ Path parameters
ParameterType
debtor_id
required · path
string
§ Body parameters
FieldType
legal_namestring
aliasesarray
identifiersobject
review_stateobject
# sandbox: full surface, no production data
curl -X PATCH https://sandbox.api.microndelta.com/v1/debtors/deb_91Lk \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f8a-bd31" \
  -d '{
  "legal_name": "string",
  "aliases": [
    "string"
  ],
  "identifiers": {},
  "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/debtors/deb_91Lk",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
        "Idempotency-Key": "4f8a-bd31",
    },
    json={
        "legal_name": "string",
        "aliases": [
            "string"
        ],
        "identifiers": {},
        "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/debtors/deb_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({
    "legal_name": "string",
    "aliases": [
      "string"
    ],
    "identifiers": {},
    "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
{
  "debtor_id": "string",
  "matter_id": "string",
  "type": "individual",
  "legal_name": "string",
  "aliases": [
    "string"
  ],
  "identifiers": {},
  "wallets": [
    "string"
  ],
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
POST/v1/debtors/{debtor_id}/graph

Build debtor graph

Builds debtor/adversary graph with aliases, entities, wallets, service targets, public records, and source-linked claims.

scope · debtors:graphidempotent · Idempotency-Key
§ Path parameters
ParameterType
debtor_id
required · path
string
§ Body parameters
FieldType
include_sourcesarray
source_refsarray
# sandbox: full surface, no production data
curl -X POST https://sandbox.api.microndelta.com/v1/debtors/deb_91Lk/graph \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f8a-bd31" \
  -d '{
  "include_sources": [
    "string"
  ],
  "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/debtors/deb_91Lk/graph",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
        "Idempotency-Key": "4f8a-bd31",
    },
    json={
        "include_sources": [
            "string"
        ],
        "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/debtors/deb_91Lk/graph", {
  method: "POST",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
    "Content-Type": "application/json",
    "Idempotency-Key": "4f8a-bd31",
  },
  body: JSON.stringify({
    "include_sources": [
      "string"
    ],
    "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…
200 Response
{
  "graph_id": "string",
  "debtor_id": "string",
  "nodes": [
    {}
  ],
  "edges": [
    {}
  ],
  "claims": [
    {
      "claim_id": "...",
      "matter_id": "...",
      "subject": "...",
      "predicate": "...",
      "object": "...",
      "source_type": "...",
      "source_refs": "...",
      "confidence": "..."
    }
  ],
  "review_state": {
    "review_required": true,
    "review_status": "not_required",
    "review_owner": "string",
    "review_notes": "string"
  }
}
POST/v1/debtors/{debtor_id}/asset-hypotheses

Create asset hypotheses

Generates source-linked asset hypotheses from debtor graph, judgment data, relationship data, and crypto attribution.

scope · debtors:graphidempotent · Idempotency-Key
§ Path parameters
ParameterType
debtor_id
required · path
string
§ Body parameters
FieldType
asset_classesarray
min_confidencenumber
# sandbox: full surface, no production data
curl -X POST https://sandbox.api.microndelta.com/v1/debtors/deb_91Lk/asset-hypotheses \
  -H "Authorization: Bearer md_test_xxxxxxxxxxxxxxxx" \
  -H "MD-Version: 2026-06-11" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f8a-bd31" \
  -d '{
  "asset_classes": [
    "string"
  ],
  "min_confidence": 123.45
}'
import requests

resp = requests.post(
    "https://sandbox.api.microndelta.com/v1/debtors/deb_91Lk/asset-hypotheses",
    headers={
        "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
        "MD-Version": "2026-06-11",
        "Idempotency-Key": "4f8a-bd31",
    },
    json={
        "asset_classes": [
            "string"
        ],
        "min_confidence": 123.45
    },
)
print(resp.json())
const resp = await fetch("https://sandbox.api.microndelta.com/v1/debtors/deb_91Lk/asset-hypotheses", {
  method: "POST",
  headers: {
    "Authorization": "Bearer md_test_xxxxxxxxxxxxxxxx",
    "MD-Version": "2026-06-11",
    "Content-Type": "application/json",
    "Idempotency-Key": "4f8a-bd31",
  },
  body: JSON.stringify({
    "asset_classes": [
      "string"
    ],
    "min_confidence": 123.45
  }),
});
console.log(await resp.json());
● 200MD-Request-Id: req_01J…
200 Response
{
  "items": [
    {
      "hypothesis_id": "string",
      "asset_type": "string",
      "description": "string",
      "confidence": 123.45,
      "source_refs": [
        "..."
      ]
    }
  ]
}