# Resolve an ANSName to an endpoint (https://developer.godaddy.com/en/docs/references/rest/ans/resolve-ans-name)

---
title: Resolve an ANSName to an endpoint
description: Resolves an ANSName to an actionable endpoint reference.
full: true
---

Full description

\| Resolves an ANSName to an actionable endpoint reference. The query includes the ANSName of the target agent and can optionally incorporate capability filters to refine the search. The ANS service queries the Agent Registry, which returns a digitally signed endpoint record if found.

## POST /v1/agents/resolution

Resolve an ANSName to an endpoint

Resolves an ANSName to an actionable endpoint reference. The query includes
the ANSName of the target agent and can optionally incorporate capability
filters to refine the search. The ANS service queries the Agent Registry,
which returns a digitally signed endpoint record if found.


### Request body (required)

Content-Type: `application/json`

Schema:

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

### Responses

**200** — Agent endpoint found

Content-Type: `application/json`

```json
{
  "ansName": "ans://v1.0.0.myagent.example.com",
  "links": [
    {
      "href": "https://api.godaddy.com/v1/agents/550e8400-e29b-41d4-a716-446655440000",
      "rel": "agent-details"
    },
    {
      "href": "https://myagent.example.com/api/v1",
      "rel": "agent-endpoint"
    }
  ]
}
```

Schema:

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

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

**422** — Invalid resolution request

Content-Type: `application/json`

Schema:

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

**500** — Internal server error

Content-Type: `application/json`

Schema:

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