> ## 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 Chain

> Retrieve the actor's signed chain, oldest first, a page at a time  
Genesis is ACTOR_REGISTERED; every later event links to the one before it, so the sequence is verifiable rather than merely ordered  
Use `chain` with a DID from the actor's `retiredActors` to page that merged actor's own chain



## OpenAPI

````yaml /versions/2026-10-16.yaml get /actors/events/{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/events/{did}:
    get:
      tags:
        - Actors
      summary: Get Actor Chain
      description: >-
        Retrieve the actor's signed chain, oldest first, a page at a time  

        Genesis is ACTOR_REGISTERED; every later event links to the one before
        it, so the sequence is verifiable rather than merely ordered  

        Use `chain` with a DID from the actor's `retiredActors` to page that
        merged actor's own chain
      operationId: actors_actorEvents
      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
        - name: pageIndex
          required: false
          in: query
          description: Zero-based page index. `0` returns the first page.
          schema:
            minimum: 0
            default: 0
            example: 0
            type: number
        - name: pageSize
          required: false
          in: query
          description: Number of items per page
          schema:
            minimum: 5
            maximum: 100
            default: 10
            example: 10
            type: number
        - name: chain
          required: false
          in: query
          description: >-
            A retired actor's DID, the `id` the actor's `retiredActors` gives
            it: pages that actor's own chain instead.
          schema:
            example: did:web:humanos.tech:user:7c9e6679-7425-40de-944b-e07fc1f90ae7
            type: string
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: >-
            Returns one page of the chain plus the total number of pages
            available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActorEventsEntity'
        '400':
          description: >-
            Invalid query parameters, e.g. a negative pageIndex or a pageSize
            outside 5-100.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 400
                  message:
                    type: string
                    example: pageIndex must not be less than 0
                  error:
                    type: string
                    example: Bad Request
        '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:
    ActorEventsEntity:
      type: object
      properties:
        data:
          type: array
          description: >-
            The signed chain, oldest first: each event a VIAEvent credential
            (v0.3 §2) with one Data Integrity proof.

            `credentialSubject.event` is the kind, `previousEvent` the
            chain-link of the event before it (null at genesis), and the kind's
            own fields sit beside them.
          items:
            type: object
            additionalProperties: true
          example:
            - '@context':
                - https://www.w3.org/ns/credentials/v2
                - https://via.humanos.tech/ns/v1
              id: urn:via:event:550e8400-e29b-41d4-a716-446655440000
              type:
                - VerifiableCredential
                - VIAEvent
              specVersion: '0.3'
              issuer: did:web:humanos.tech
              validFrom: '2026-10-01T09:12:00.000Z'
              credentialSubject:
                id: >-
                  did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35
                event: ACTOR_REGISTERED
                previousEvent: null
                actorType: agent
                keyId: >-
                  did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35#key-1
                publicKeyJwk:
                  kty: EC
                  crv: P-256
                  x: …
                  'y': …
                assurance: pop
                binding: self
                bootstrapAnchor: api_key
                verifiedAt: '2026-10-01T09:12:00.000Z'
                existedSince: '2026-10-01T09:12:00.000Z'
                attestationKind: device-self
              proof:
                type: DataIntegrityProof
                cryptosuite: eddsa-jcs-2022
                verificationMethod: did:web:humanos.tech#key-1
                created: '2026-10-01T09:12:00.000Z'
                proofPurpose: assertionMethod
                proofValue: z2pcVdSdoMTrkTRrXdz...
        totalPages:
          type: number
          description: >-
            Total number of pages available based on the page size and total
            count
          example: 1
      required:
        - data
        - totalPages

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.