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

# Get Agent

> Retrieve an agent and its environment pointers.

### Overview

Returns one agent with its `dev`, `staging`, and `production` environments and the version each is pinned to. Use [List Agents](/api-v2/get/agents) to find agent IDs.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="agent_id" type="string" required>
  The agent's unique identifier.
</ParamField>

### Response

<ResponseField name="data" type="object">
  The agent with its environments.

  <Expandable title="agent object">
    <ResponseField name="id" type="string">
      Unique identifier for the agent.
    </ResponseField>

    <ResponseField name="org_id" type="string">
      The organization that owns the agent.
    </ResponseField>

    <ResponseField name="name" type="string">
      The agent's display name.
    </ResponseField>

    <ResponseField name="created_by" type="string | null">
      ID of the user who created the agent, or `null` when created with an org-level key.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of the last update.
    </ResponseField>

    <ResponseField name="deleted_at" type="null">
      Always `null` on a live agent.
    </ResponseField>

    <ResponseField name="environments" type="array">
      The agent's three environments. Each has `id`, `env_type` (`dev`, `staging`, or `production`), and `current_version_id` (the pinned version, or `null` if unpinned).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="null | array">
  `null` on success, or a list of error objects if the request failed.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "id": "76d33db4-6e21-4505-b730-97a02e50d2ac",
      "org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
      "name": "Front desk",
      "created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
      "created_at": "2026-09-10T22:59:51.569Z",
      "updated_at": "2026-09-10T23:14:08.220Z",
      "deleted_at": null,
      "environments": [
        {
          "id": "7a043546-b896-4680-80e4-5eb9cbde6977",
          "env_type": "dev",
          "current_version_id": null
        },
        {
          "id": "ab412aa2-8827-4e12-ad45-9a964c2c8690",
          "env_type": "staging",
          "current_version_id": null
        },
        {
          "id": "1595512d-ea18-4692-a40b-6c90932396b4",
          "env_type": "production",
          "current_version_id": "bc526394-c150-4983-bbfb-c84d1d9653f4"
        }
      ]
    },
    "errors": null
  }
  ```

  ```json Not Found theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "NOT_FOUND",
        "message": "Agent not found"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)