domain.retrieve()
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

Retrieve a permissioned domain by id (point-in-time).

Signature

domain.retrieve(
  params: DomainRetrieveParams,
): Promise<DomainRetrieveResult>

Parameter	Type	Required	Description
`domainID`	`string`	Yes	The domain id to fetch.

Resolves to a DomainRetrieveResult:

Field	Type	Description
`domainID`	`string`	The queried domain id.
`data`	`DomainData \| undefined`	The domain snapshot, or `undefined` if no such domain exists.

Field	Type	Description
`domainID`	`string`	The domain's on-chain id.
`owner`	`string`	The owning account's r-address.
`credList`	`readonly AcceptedCredential[]`	The credentials the domain accepts (each `{ issuer, credType }`, credential types decoded from hex).

Read-only — no signer is required and nothing is submitted. Queries the ledger with ledger_entry.

const { data } = await client.domain.retrieve({
  domainID: 'A1B2...',
})

console.log(data?.owner)