Skip to content
Dark MatterDark Matter
API

Identity API

API reference for participant registration and lookup in the Identity Graph.

POST /v1/identity/participants

Register a new participant in the Identity Graph. Participants represent natural persons, entities, or institutions that can own positions or be parties to transfers.

Request

{
  "participant_id": "part-buyer-001",
  "name": "Acme Capital LLC",
  "type": "entity",
  "accreditation_status": "verified",
  "kyc_status": "approved",
  "aml_status": "cleared",
  "is_us_person": true,
  "is_foreign_person": false,
  "qualified_purchaser_status": "not_verified",
  "bad_actor_screened": true,
  "bad_actor_flag": false
}

Response (201)

Returns the created participant record. Returns 409 if a participant with the same ID already exists.


GET /v1/identity/participants

List all registered participants.

Response

[
  {
    "participant_id": "part-gp-a",
    "name": "Megalith Ventures GP LLC",
    "type": "entity",
    "accreditation_status": "verified",
    "kyc_status": "approved",
    "aml_status": "cleared",
    "is_us_person": true,
    "is_foreign_person": false
  },
  {
    "participant_id": "part-buyer-001",
    "name": "Acme Capital LLC",
    ...
  }
]

GET /v1/identity/participants/:id

Retrieve a single participant by ID.

Response

Returns the full participant record. Returns 404 if the participant does not exist.

Edit this page on GitHub

Last reviewed: March 24, 2026

Was this page helpful?