> ## Documentation Index
> Fetch the complete documentation index at: https://help.onetsolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# [TLDs] Check domain availability

> Check whether a specific domain name is available for registration. The response includes the availability status, registration price if available, and any premium pricing that may apply. For unavailable domains, additional information about the current registration status may be provided when available from the registry.



## OpenAPI

````yaml https://api.onetsolutions.net/schema get /v1/domains/tlds/check/{domain_name}
openapi: 3.0.3
info:
  title: OnetSolutions API
  version: v1 (v1)
  description: >

    ## Overview


    The OnetSolutions API provides programmatic access to manage your cloud
    infrastructure, domains, and web hosting services.


    ## Authentication


    All API requests require authentication using one of the following methods:


    - **JWT Token**: Obtain a token via login endpoints and include it in the
    `Authorization: Bearer <token>` header

    - **API Key**: Generate an API key from your account settings and use it as
    `Authorization: Bearer sk-onetsolutions-...`


    ## Rate Limiting


    API requests are rate-limited to ensure fair usage:

    - **Standard**: 1000 requests per minute

    - **Burst**: 100 requests per second


    ## Pagination


    List endpoints return paginated results. Use `page` and `page_size` query
    parameters.


    ## Error Handling


    The API uses standard HTTP status codes:

    - `200` Success

    - `201` Created

    - `400` Bad Request

    - `401` Unauthorized

    - `403` Forbidden

    - `404` Not Found

    - `429` Too Many Requests
servers:
  - url: https://api.onetsolutions.net
    description: Production
security: []
tags:
  - name: Authentication
    description: >-
      Login, passwordless authentication, MFA, OAuth providers, and token
      management.
  - name: Organizations
    description: >-
      Organization management, members, roles, modules, audit logs, and
      notification settings.
  - name: Projects
    description: Project management, team members, and project-scoped resources.
  - name: Compute
    description: >-
      Cloud instances, volumes, snapshots, backups, VPCs, firewalls, SSH keys,
      uptime monitors, and instance tasks.
  - name: Domains
    description: >-
      Domain availability, registration, transfers, DNS zones, DNS records, and
      TLD information.
  - name: Web Hosting
    description: >-
      cPanel-based web hosting, emails, databases, subdomains, FTP accounts,
      addon domains, and SSL certificates.
paths:
  /v1/domains/tlds/check/{domain_name}:
    get:
      tags:
        - Domains
      summary: '[TLDs] Check domain availability'
      description: >-
        Check whether a specific domain name is available for registration. The
        response includes the availability status, registration price if
        available, and any premium pricing that may apply. For unavailable
        domains, additional information about the current registration status
        may be provided when available from the registry.
      operationId: check_tld_domain_availability
      parameters:
        - in: path
          name: domain_name
          schema:
            type: string
          description: >-
            The fully qualified domain name to check (e.g., example.com,
            mysite.org)
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainAvailability'
          description: Domain availability check completed successfully
        '400':
          description: Invalid domain name format or unsupported TLD
        '401':
          description: Authentication credentials were not provided or are invalid
        '429':
          description: Rate limit exceeded. Too many availability checks in a short period
        '500':
          description: Failed to check availability with the registry
      security:
        - BearerAuth: []
        - {}
components:
  schemas:
    DomainAvailability:
      type: object
      properties:
        domain_name:
          type: string
        is_available:
          type: boolean
          nullable: true
        price:
          type: string
          pattern: ^-?\d{0,8}(?:\.\d{0,2})?$
          nullable: true
        currency:
          type: string
        premium:
          type: boolean
        error:
          type: string
      required:
        - domain_name
        - is_available
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: >-
        Use `Authorization: Bearer <token>` header. Token can be a JWT token or
        an API key (format: `sk-onetsolutions-...`).

````