# Check Availability

CheckAvailability will check a list of domains to see if they are purchasable. A Maximum of 50 domains can be specified.

Endpoint: POST /core/v1/domains:checkAvailability
Version: 1.3.1
Security: BasicAuth

## Request fields (application/json):

  - `domainNames` (array, required)
    DomainNames is the list of domains to check if they are available.

## Response 200 fields (application/json):

  - `results` (array)
    Results of the search are returned here, the order should not be relied upon.

  - `results.domainName` (string, required)
    DomainName is the punycode encoding of the result domain name.
    Example: "example.com"

  - `results.premium` (boolean)
    Premium indicates that this search result is a premium result and the purchase_price needs to be passed to the DomainCreate command. This parameter will only be returned for domains that are purchasable.
    Example: true

  - `results.purchasable` (boolean, required)
    Purchasable indicates whether the search result is available for purchase.
    Example: true

  - `results.purchasePrice` (number)
    PurchasePrice is the price for purchasing this domain for the minimum time period (typically 1 year). Purchase_price is always in USD. This parameter will only be returned for domains that are purchasable.
    Example: 10.99

  - `results.purchaseType` (string)
    PurchaseType indicates what kind of purchase this result is for. It should be passed to the DomainCreate command. This parameter will only be returned for domains that are purchasable.
    Example: "registration"

  - `results.renewalPrice` (number)
    RenewalPrice is the annual renewal price for this domain as it may be different than the purchase_price. This parameter will only be returned for domains that are purchasable.
    Example: 10.99

  - `results.sld` (string, required)
    SLD is first portion of the domain_name.
    Example: "example"

  - `results.tld` (string, required)
    TLD is the rest of the domain_name after the SLD.
    Example: "com"

## Response 401 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Unauthorized"

## Response 415 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "The 'Content-Type' header must be 'application/json' for this request."

## Response 422 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Unprocessable Entity"

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 502 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Registry Connection Unavailable"