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

---
title: Retrieve agent details
description: Returns a single registered agent with trust explainability details.
full: true
---

Full description

Returns a single registered agent with trust explainability details. Search-only ranking scores are not included.

## GET /v1/ans/registered-agents/{agentId}

Retrieve agent details

Returns a single registered agent with trust explainability details. Search-only ranking scores are not included.

### Path parameters

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

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `profile` | string | no | Scoring profile name (default: `default`). |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | string <uuid> | no | Optional request identifier propagated across services. |

### Responses

**200** — Successful agent detail retrieval

Content-Type: `*/*`

Schema:

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

**400** — Malformed request syntax or invalid encoding

Content-Type: `*/*`

Schema:

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

**401** — Authentication info not sent or is invalid

Content-Type: `*/*`

Schema:

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

**403** — Authenticated user is not allowed access

Content-Type: `*/*`

Schema:

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

**404** — Resource not found

Content-Type: `*/*`

Schema:

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

**422** — Request validation failed

Content-Type: `*/*`

Schema:

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

**429** — Too many requests - rate limit exceeded

Content-Type: `*/*`

Schema:

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

**500** — Internal server error

Content-Type: `*/*`

Schema:

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

**502** — Bad gateway or failed dependency

Content-Type: `*/*`

Schema:

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

**503** — Service is temporarily unavailable

Content-Type: `*/*`

Schema:

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

**504** — Gateway or dependency timeout

Content-Type: `*/*`

Schema:

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