> ## Documentation Index > Fetch the complete documentation index at: https://docs.humanos.tech/llms.txt > Use this file to discover all available pages before exploring further. # Get Actor > Retrieve an actor by any of its DIDs: an organization, a person or an agent Its VIAActor record (v0.3 §3.1) is under `record`, null while its registration is queued Beside the record: when its last event was signed, whether an event of it is not yet on its chain (`pending`), and the actors merged into it ## OpenAPI ````yaml /versions/2026-10-16.yaml get /actors/{did} openapi: 3.1.0 info: title: Humanos API description: Humanos API version: '1.0' contact: {} servers: - url: https://api.humanos.tech security: [] tags: - name: humanosApp description: '' paths: /actors/{did}: get: tags: - Actors summary: Get Actor description: >- Retrieve an actor by any of its DIDs: an organization, a person or an agent Its VIAActor record (v0.3 §3.1) is under `record`, null while its registration is queued Beside the record: when its last event was signed, whether an event of it is not yet on its chain (`pending`), and the actors merged into it operationId: actors_actor parameters: - name: did required: true in: path description: >- Any of the actor's DIDs, URL-encoded: an organization's, a person's or an agent's, or one it absorbed by a merge. schema: example: did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35 type: string - $ref: '#/components/parameters/ApiVersion' responses: '200': description: >- Returns the actor record, its last event date, whether an event is pending, and the actors merged into it. content: application/json: schema: $ref: '#/components/schemas/ActorEntity' '404': description: >- No actor has this DID, or your organization may not read it: an organization reads itself, its agents, and the people it knows. content: application/json: schema: type: object properties: statusCode: type: number example: 404 message: type: string example: actor not found error: type: string example: Not Found components: parameters: ApiVersion: name: API-Version in: header required: false schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ example: '2026-10-16' description: >- Pin request, response, and webhook shapes to a specific dated API version (YYYY-MM-DD). Omit to use the version pinned to your API key (set when the key is created; new keys default to the latest version). New integrations should target the latest version. schemas: ActorEntity: type: object properties: record: type: - object - 'null' description: >- The VIAActor record (v0.3 §3.1), exactly as the fold of its chain gives it: `id`, `actorType`, `status` (`active | suspended | retired`), `keys`, the assurance fields, `operator`, `aliases` (each with its reason), `accreditation`, `existedSince`, `anchoredBy`, `chain` and the rest. Null while its registration is queued. additionalProperties: true example: id: did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35 actorType: agent status: active keys: - id: >- did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35#key-1 publicKeyJwk: kty: EC crv: P-256 x: … 'y': … status: active assurance: pop binding: self verifiedAt: '2026-10-01T09:12:00.000Z' attestation: event: sha256-… kind: device-self assurance: pop binding: self bootstrapAnchor: api_key verifiedAt: '2026-10-01T09:12:00.000Z' operator: org: did:web:humanos.tech:org:04ad6920-e048-4dd8-9379-21c1f344df6d relation: operates affiliationEvent: sha256-… existedSince: '2026-10-01T09:12:00.000Z' chain: genesisEvent: sha256-… headEvent: sha256-… sequence: 2 lastEventAt: type: - string - 'null' description: >- When the chain's last event was signed. Null until the first event is written. example: '2026-10-01T09:12:00.000Z' pending: type: boolean description: >- True while an event of the actor is accepted and not yet on its chain — queued, being written, or failed and waiting on an operator. `record` already holds it, so it leads `record.chain` until the event is written (v0.3 §5). example: false retiredActors: description: >- The actors merged into this one, merges of merges included, each with where its own chain ends. type: array items: $ref: '#/components/schemas/RetiredActorEntity' required: - record - lastEventAt - pending - retiredActors RetiredActorEntity: type: object properties: id: type: string description: >- Its DID. Page its own chain with `GET actors/events/:did?chain=`. example: did:web:humanos.tech:user:3f2a7c10-0b1e-4c5d-9a2f-6e8d1c4b7a90 succeededBy: type: - string - 'null' description: The actor it retired into. example: did:web:humanos.tech:user:7c9e6679-7425-40de-944b-e07fc1f90ae7 chain: description: Where its own chain ends. anyOf: - $ref: '#/components/schemas/ActorChainEntity' - type: 'null' lastEventAt: type: - string - 'null' description: When its last event was signed. example: '2026-10-01T09:12:00.000Z' required: - id - succeededBy - chain - lastEventAt ActorChainEntity: type: object properties: genesisEvent: type: string description: The chain-link of its first event, the genesis. example: sha256-… headEvent: type: string description: The chain-link of its last event. example: sha256-… sequence: type: number description: How many events it holds, the genesis counting as 1. example: 6 required: - genesisEvent - headEvent - sequence ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.