# Search domain availability and pricing

> Search domain availability and pricing: CustomDomain™ API reference in the registrar group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/registrar/searchDomains

## `GET https://api.customdomain.ai/v1/registrar/search`

Availability and retail prices for the typed name. With `suggest=1` it also returns the same name on other TLDs and close variants, each result carrying a `kind` (`exact`, `tld` or `variant`). A widget token of either scope, a tenant API key of any role, or a delegated agent token with `domains:read` may search.

### Authentication

`widgetJWT`, `apiKey`, `agentToken`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `q` | query | string | yes |  |
| `suggest` | query | `1` | no | Send `1` for the shop style search: the typed name, the same name on other TLDs and close variants, each with a `kind`. |

### Responses

| Status | Description |
| --- | --- |
| `200` | Results |
| `401` | Error envelope: {code, title, details}. |
| `403` | Error envelope: {code, title, details}. |
| `503` | Error envelope: {code, title, details}. |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.