logo
OpenapiSearch

Check domain availability

API Docs with browser client
GET
/search/availability

Check if a domain is available for registration. Returns availability status, pricing details, current owner (if any), and registration constraints.

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

domain*string

The domain to check availability for

Match^[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?(\.[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?)*$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "http://backend.astra.namefi.dev/v-next/search/availability?domain=string"
{
  "domain": "string",
  "availability": true,
  "pricingDetails": {
    "registrationPrice": {
      "type": "PER_YEAR",
      "price": {
        "amount": 0,
        "currency": "string"
      }
    },
    "renewalPrice": {
      "type": "PER_YEAR",
      "price": {
        "amount": 0,
        "currency": "string"
      }
    },
    "importPrice": {
      "type": "PER_YEAR",
      "price": {
        "amount": 0,
        "currency": "string"
      }
    }
  },
  "currentOwner": "string",
  "registrarKey": "string",
  "durationValidationInYears": {
    "min": 0,
    "max": 0
  },
  "importable": true,
  "supported": true
}
{
  "defined": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "Bad Request",
  "data": null
}
{
  "defined": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Unauthorized",
  "data": null
}
{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "Forbidden",
  "data": null
}
{
  "defined": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Not Found",
  "data": null
}
{
  "defined": true,
  "code": "NOT_ACCEPTABLE",
  "status": 406,
  "message": "Not Acceptable",
  "data": null
}
{
  "defined": true,
  "code": "TIMEOUT",
  "status": 408,
  "message": "Request Timeout",
  "data": null
}
{
  "defined": true,
  "code": "CONFLICT",
  "status": 409,
  "message": "Conflict",
  "data": null
}
{
  "defined": true,
  "code": "PRECONDITION_FAILED",
  "status": 412,
  "message": "Precondition Failed",
  "data": null
}
{
  "defined": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "Too Many Requests",
  "data": null
}
{
  "defined": true,
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal Server Error",
  "data": null
}

Instant Register domain POST

Purchase a single domain instantly without adding to cart. Validates domain availability, creates payments and order, then starts the order processing workflow.

Get domain suggestions GET

Generate domain suggestions based on a search query. Supports pagination and optional parent domain filtering for third-level domain suggestions.