# 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
pageId: 54c7d4b4-a46f-4333-a7e3-1bc81c690faa
---

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

**Security:** requires `oauth2`, `PAT`, `sso-key`; scopes `ans.agent-registration:read`, `ans.agent-registration:write`.