# Retrieve agent details (https://developer.godaddy.com/en/docs/references/rest/ans/get-agent)

---
title: Retrieve agent details
description: Retrieves detailed information about a registered agent
full: true
---

## GET /v1/agents/{agentId}

Retrieve agent details

Retrieves detailed information about a registered agent

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `agentId` | string | yes | Unique identifier of the agent |

### Responses

**200** — Agent details retrieved successfully

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/AgentDetails`

**401** — Authentication failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**403** — Authorization failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**404** — Agent not found

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`