> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talaria.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve a DID

> Return the public record for a Talaria DID.

Return the public record for a Talaria DID.

## Request

<ParamField path="did" type="string" required>
  The complete Talaria DID to resolve.
</ParamField>

<RequestExample>
  ```bash Request theme={null}
  curl --request GET \
    --url "https://directory.example.com/resolve/did%3Atalaria%3A1111111111111111111111"
  ```
</RequestExample>

## Response

<ResponseField name="owner" type="string" required>
  The public owner address.
</ResponseField>

<ResponseField name="alias" type="string">
  The current public alias, when set.
</ResponseField>

<ResponseField name="version" type="number" required>
  The public record version.
</ResponseField>

<ResponseField name="document" type="object" required>
  The public DID document.
</ResponseField>

<ResponseField name="updatedAt" type="number" required>
  The update time as Unix milliseconds.
</ResponseField>

<ResponseField name="freshness" type="string" required>
  The source freshness label.
</ResponseField>

<ResponseField name="registration_status" type="string" required>
  The public registration state.
</ResponseField>

<ResponseField name="root_pubkey" type="string">
  The public root key, when available.
</ResponseField>

<ResponseField name="tx_id" type="string">
  The registration transaction identifier, when available.
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "owner": "5ExampleOwnerAddress",
    "alias": "river.stone",
    "version": 3,
    "document": {
      "id": "did:talaria:1111111111111111111111",
      "verificationMethod": [],
      "authentication": [],
      "keyAgreement": [],
      "service": []
    },
    "updatedAt": 1784236800000,
    "freshness": "cache",
    "registration_status": "confirmed"
  }
  ```
</ResponseExample>

<Note>
  `200` returns the record. `404` means the DID was not found. `425` means registration is awaiting confirmation.
</Note>
