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

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

Search registered agents

Searches registered agents using request-body criteria and returns ranked results.

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