DID Node API

Health Check

get

Health check endpoint

Responses

200

Successful Response

application/json

anyOptional

get/health

GET /health HTTP/1.1
Accept: */*

200

Successful Response

No content

Api Resolve

get

Resolve DID document

Query parameters

didstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

get/did/resolve

GET /did/resolve?did=text HTTP/1.1
Accept: */*

No content

Api List Dids

get

List DIDs with optional filtering by controller or public_key_multibase, and pagination

Query parameters

pageinteger · min: 1OptionalDefault: 1

page_sizeinteger · min: 1 · max: 100OptionalDefault: 20

controllerstring · nullableOptional

public_keystring · nullableOptional

key_typestring · nullableOptional

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

get/did/list

GET /did/list HTTP/1.1
Accept: */*

No content

Did History

get

Get the complete history of DID operations

Query parameters

didstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

get/did/history

GET /did/history?did=text HTTP/1.1
Accept: */*

No content

Did At Height

get

Get DID document state at specific block height

Query parameters

didstringRequired

heightintegerRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

get/did/at_height

GET /did/at_height?did=text&height=1 HTTP/1.1
Accept: */*

No content

Api Create

post

Create a new DID and return PSBT

Body

spend_addrstringRequired

verification_capabilitiesintegerRequired

control_addressstringRequired

subject_public_keystringRequired

key_typestringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post/did/create

POST /did/create HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "spend_addr": "text",
  "verification_capabilities": 1,
  "control_address": "text",
  "subject_public_key": "text",
  "key_type": "text"
}

No content

Api Update

post

Update DID and return PSBTs

Body

spend_addrstringRequired

control_addressstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post/did/update

POST /did/update HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "original_utxo": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "spend_addr": "text",
  "vm_updates": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "control_address": "text"
}

No content

Api Deactivate

post

Deactivate DID and return PSBT

Body

spend_addrstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post/did/deactivate

POST /did/deactivate HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "original_utxo": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "spend_addr": "text"
}

No content

Batch Get Dids

post

Batch query DID documents by DID list (limit: max 100)

Body

didsstring[]Required

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post/did/batch_get

POST /did/batch_get HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "dids": [
    "text"
  ]
}

No content

Did Verify

post

Verify DID signature

Query parameters

didstringRequired

signaturestringRequired

datastringRequired

sign_typestring · nullableOptional

Signature type: standard, unisat, bitcoin_message

Default: standard

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post/did/verify

POST /did/verify?did=text&signature=text&data=text HTTP/1.1
Accept: */*

No content