# Get available domains for registration

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/domains/available:
    post:
      summary: Get available domains for registration
      deprecated: false
      description: "This endpoint returns a list of domains that are available for registration, along with the exact match and a list of similar domains for a given set of TLDs and years of registration.\n\n> Note: Only the following TLDs are allowed for registration - \n> \t`com`, `net`,  `org`, `biz`, `live`, `info`\n"
      tags:
        - domains
      parameters:
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: x-workspace-key
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: x-service-provider
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                domainName:
                  type: string
                  x-apidog-mock: company.com
                  description: >-
                    Domain name to check availability for and fetch similar
                    domains.
                tlds:
                  type: array
                  items:
                    type: string
                    description: List of TLDs to target (eg. "com", "live", "info", etc)
                    x-apidog-mock: '["com"]'
                years:
                  type: integer
                  description: >-
                    Number of years to register the domain for. (Default is 1
                    year)
                  x-apidog-mock: '1'
              required:
                - domainName
              x-apidog-orders:
                - domainName
                - tlds
                - years
            example:
              domainName: company.com
              tlds:
                - com
              years: 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      availableDomains:
                        type: array
                        items:
                          type: object
                          properties:
                            domainName:
                              type: string
                            status:
                              type: string
                            domainPrice:
                              type: string
                            renewPrice:
                              type: string
                          required:
                            - domainName
                            - status
                            - domainPrice
                            - renewPrice
                          x-apidog-orders:
                            - domainName
                            - status
                            - domainPrice
                            - renewPrice
                    required:
                      - availableDomains
                    x-apidog-orders:
                      - availableDomains
                required:
                  - status
                  - message
                  - data
                x-apidog-orders:
                  - status
                  - message
                  - data
          headers: {}
          x-apidog-name: Success
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  errorId:
                    type: string
                required:
                  - status
                  - message
                  - errorId
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: domains
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797058/apis/api-13521189-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```