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

# GET /v1/agents/{id}: Get AI Agent Details | DeltaLead

> GET /v1/agents/{id} — fetch full configuration details for a single AI agent including tone, handoff triggers, and follow-up cadence.

Use this endpoint to fetch the complete configuration of a single AI agent by its ID. The response includes every setting that governs how the agent communicates — its tone, the topics it is permitted to discuss, the conditions under which it hands off to a human seller, and the cadence it follows when sending automated follow-ups.

## Endpoint

```http theme={null}
GET https://platform-api.deltalead.ai/v1/agents/{id}
```

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the agent to retrieve, e.g. `agent_abc123`.
</ParamField>

## Example Request

```bash cURL theme={null}
curl https://platform-api.deltalead.ai/v1/agents/agent_abc123 \
  -H "X-API-Key: YOUR_API_KEY"
```

## Response

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

<ResponseField name="organization_id" type="string">
  ID of the organization this agent belongs to.
</ResponseField>

<ResponseField name="name" type="string">
  Display name of the agent.
</ResponseField>

<ResponseField name="status" type="string">
  Current status: `active`, `inactive`, or `draft`.
</ResponseField>

<ResponseField name="language" type="string">
  Language locale the agent uses: `es-AR`, `es-MX`, `es-CR`, `es-CO`, `pt-BR`, or `en-US`.
</ResponseField>

<ResponseField name="channels" type="array">
  Channels the agent is assigned to: `whatsapp`, `facebook`, `instagram`, `web`, `email`, or `phone`.
</ResponseField>

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

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

<ResponseField name="configuration" type="object">
  Full behavioral configuration for the agent.

  <Expandable title="Configuration fields">
    <ResponseField name="tone" type="string">
      Conversational tone used by the agent: `formal`, `friendly`, or `professional`.
    </ResponseField>

    <ResponseField name="handoff_triggers" type="array">
      List of topics or situations that cause the agent to transfer the conversation to a human seller, e.g. `"pricing negotiation"` or `"financing"`.
    </ResponseField>

    <ResponseField name="allowed_topics" type="array">
      List of topics the agent is permitted to discuss, e.g. `"vehicle availability"` or `"test drive scheduling"`.
    </ResponseField>

    <ResponseField name="follow_up_cadence" type="object">
      Settings that control automated follow-up messages.

      <Expandable title="Follow-up cadence fields">
        <ResponseField name="max_follow_ups" type="integer">
          Maximum number of follow-up messages the agent will send per lead.
        </ResponseField>

        <ResponseField name="interval_days" type="integer">
          Number of days to wait between each follow-up message.
        </ResponseField>

        <ResponseField name="channel" type="string">
          Channel used to send follow-up messages, e.g. `whatsapp`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

```json 200 OK theme={null}
{
  "id": "agent_abc123",
  "organization_id": "org_xyz789",
  "name": "Martín de Ventas",
  "status": "active",
  "language": "es-AR",
  "channels": ["whatsapp", "instagram"],
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-10-01T08:30:00Z",
  "configuration": {
    "tone": "friendly",
    "handoff_triggers": [
      "pricing negotiation",
      "financing",
      "trade-in valuation"
    ],
    "allowed_topics": [
      "vehicle availability",
      "pricing",
      "test drive scheduling",
      "financing options"
    ],
    "follow_up_cadence": {
      "max_follow_ups": 5,
      "interval_days": 3,
      "channel": "whatsapp"
    }
  }
}
```

## Error Responses

```json 404 Not Found theme={null}
{
  "error": "not_found",
  "message": "No agent with ID agent_abc123 exists in your organization."
}
```