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

# Get Agent

> Get a specific agent by ID

Returns details for a specific agent.

## Path Parameters

<ParamField path="id" type="string" required>
  The agent ID (e.g., `agt_abc123`)
</ParamField>

## Response

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

<ResponseField name="name" type="string">
  Agent name
</ResponseField>

<ResponseField name="killed" type="boolean">
  Whether the kill switch is active
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp
</ResponseField>

<ResponseField name="lastActiveAt" type="string">
  Last API call timestamp
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.saturn-pay.com/v1/agents/agt_abc123 \
    -H "Authorization: Bearer sk_agt_..."
  ```

  ```typescript Node.js theme={null}
  const agentId = 'agt_abc123';
  const response = await fetch(`https://api.saturn-pay.com/v1/agents/${agentId}`, {
    headers: { 'Authorization': 'Bearer sk_agt_...' }
  });

  const agent = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "agt_abc123",
    "name": "research-agent",
    "killed": false,
    "createdAt": "2024-01-15T10:30:00Z",
    "lastActiveAt": "2024-01-20T14:22:00Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "NOT_FOUND",
      "message": "Agent not found"
    }
  }
  ```
</ResponseExample>
