Get registration status - Talaria Developer Documentation

curl --request GET \
  --url "https://directory.example.com/registration-status/did%3Atalaria%3A1111111111111111111111"

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": true,
  "registration_status": "confirmed",
  "did_document": {
    "id": "did:talaria:1111111111111111111111"
  },
  "version": 0,
  "tx_id": "<transaction-id>"
}

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": false,
  "registration_status": "pending",
  "tx_id": "<transaction-id>"
}

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": false,
  "registration_status": "missing"
}

curl --request GET \
  --url "https://directory.example.com/registration-status/did%3Atalaria%3A1111111111111111111111"

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": true,
  "registration_status": "confirmed",
  "did_document": {
    "id": "did:talaria:1111111111111111111111"
  },
  "version": 0,
  "tx_id": "<transaction-id>"
}

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": false,
  "registration_status": "pending",
  "tx_id": "<transaction-id>"
}

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": false,
  "registration_status": "missing"
}

Read the chain-authoritative registration state for a DID. Use this endpoint after POST /register-did returns 202 Accepted. The Directory may retain a pending submission receipt, but it reports a registration as confirmed only after the DID exists on chain.

Request

string

required

The complete did:talaria:... identifier. URL-encode it when placing it in the path.

curl --request GET \
  --url "https://directory.example.com/registration-status/did%3Atalaria%3A1111111111111111111111"

Response

string

required

The DID whose registration state was checked.

string

required

chain, indicating that confirmation was checked against chain state.

boolean

required

true only when the DID exists on chain.

string

required

One of confirmed, pending, or missing.

object

The confirmed public DID document. Present when registration_status is confirmed.

number

The confirmed on-chain record version.

string

The known registration transaction identifier for a pending or confirmed submission.

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": true,
  "registration_status": "confirmed",
  "did_document": {
    "id": "did:talaria:1111111111111111111111"
  },
  "version": 0,
  "tx_id": "<transaction-id>"
}

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": false,
  "registration_status": "pending",
  "tx_id": "<transaction-id>"
}

{
  "did": "did:talaria:1111111111111111111111",
  "source": "chain",
  "registered": false,
  "registration_status": "missing"
}

200 OK describes the current registration state, including missing. A 502 means the Directory could not verify chain state; do not treat that error as a missing registration.

Straight to the point

GET /registration-status/{url-encoded-did}

Authentication: none
Request body: none
Confirmation source: chain
Retry while the state is pending

​Request

​Response

​Straight to the point

Request

Response

Straight to the point