# Search registered agents (https://developer.godaddy.com/en/docs/references/rest/ans/search-registered-agents)

---
title: Search registered agents
description: >-
  Searches registered agents using request-body criteria and returns ranked
  results.
full: true
pageId: 2bb1e986-78a7-4bb9-8f81-3acc8ae02ad9
---

Full description

Searches registered agents using request-body criteria and returns ranked results. Anonymous requests are accepted when the Authorization header is omitted and are rate limited to 60 requests per minute per client IP.

## POST /v1/ans/search-registered-agents

Search registered agents

Searches registered agents using request-body criteria and returns ranked results. Anonymous requests are accepted when the Authorization header is omitted and are rate limited to 60 requests per minute per client IP.

### Header parameters

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

### Request body (required)

Search parameters

Content-Type: `application/json`

Schema:

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

### Responses

**200** — Successful response containing a paged list of registered agents

Content-Type: `*/*`

Schema:

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

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

**415** — Unsupported or missing media type

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`

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