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

> One of the organization's agents: its name, status and rung, its keys, when it registered, how many tools it declared and the policy version in force



## OpenAPI

````yaml /versions/2026-11-02.yaml get /agents/{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: Agents
  - name: Requests
  - name: Credentials
  - name: Approval
  - name: User
  - name: Actions
  - name: Audit trail
  - name: DID
  - name: Call proof
  - name: Webhooks
paths:
  /agents/{did}:
    get:
      tags:
        - Agents
      summary: Get Agent
      description: >-
        One of the organization's agents: its name, status and rung, its keys,
        when it registered, how many tools it declared and the policy version in
        force
      operationId: agents_get
      parameters:
        - name: did
          required: true
          in: path
          description: The agent's DID, URL-encoded.
          schema:
            example: did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35
            type: string
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Returns the agent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDetailEntity'
        '404':
          description: >-
            The agent is unknown, or another organization operates it: an
            organization only reads its own agents.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 404
                  message:
                    type: string
                    example: agent 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-11-02'
      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:
    AgentDetailEntity:
      type: object
      properties:
        did:
          type: string
          description: The agent's DID.
          example: did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35
        name:
          type: string
          description: >-
            What the organization calls it: its label, else the app and person
            acting through it, else a name from its DID.
          example: Payments agent
        status:
          type: string
          description: The actor's status (v0.3 §4).
          enum:
            - active
            - suspended
            - retired
          example: active
        assurance:
          type: string
          description: >-
            The lowest rung across its usable keys (v0.3 §9.1bis); absent when
            no usable key carries one.
          example: pop
        binding:
          type: string
          description: >-
            Who holds its keys, for that rung: `self`, `custodial` (the
            platform) or `attested`.
          example: custodial
        keys:
          description: Every key on the actor, rotated and revoked ones included.
          type: array
          items:
            $ref: '#/components/schemas/AgentDetailKeyEntity'
        registeredAt:
          format: date-time
          type: string
          description: When the agent was registered.
          example: '2026-09-02T10:15:00.000Z'
        toolCount:
          type: number
          description: How many tools its latest declaration lists.
          example: 12
        policyVersion:
          type:
            - number
            - 'null'
          description: >-
            The number of the organization's policy version in force, which
            decides the agent's calls; null when it has none.
          example: 3
      required:
        - did
        - name
        - status
        - keys
        - registeredAt
        - toolCount
        - policyVersion
    AgentDetailKeyEntity:
      type: object
      properties:
        id:
          type: string
          description: 'The key id, `<did>#key-<n>`: what a mandate pins.'
          example: >-
            did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35#key-1
        status:
          type: string
          description: >-
            `active`; `rotated`, still signing until its window ends; or
            `revoked`.
          enum:
            - active
            - rotated
            - revoked
          example: active
        assurance:
          type: string
          description: 'The rung the key earned: `pop`, `device` or `hardware`.'
          example: pop
        binding:
          type: string
          description: 'Who holds it: `self`, `custodial` (the platform) or `attested`.'
          example: custodial
        verifiedAt:
          type: string
          description: When its evidence was last verified.
          example: '2026-09-02T10:15:00.000Z'
        rotatedTo:
          type: string
          description: 'A rotated key: the key that replaced it.'
          example: >-
            did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35#key-2
      required:
        - id
        - status

````

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