api-ninjas-com Whois API

openapi: 3.2.0
info:
  title: Ninjas Whois API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Whois
  description: The Whois API retrieves domain registration information for any given domain using the WHOIS protocol.
paths:
  /v1/whois:
    get:
      tags:
      - Whois
      summary: Get domain registration details
      description: Returns WHOIS registration details for a `domain`, including registrar, creation and expiry dates. For risk and email-provider signals use /domain.
      operationId: getWhois
      parameters:
      - $ref: '#/components/parameters/WhoisOpenapi_domain'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhoisResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhoisOpenapi_ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhoisOpenapi_ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhoisOpenapi_ErrorResponse'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    WhoisResponse:
      type: object
      description: Domain registration details.
      properties:
        domain_name:
          type: string
          example: example.com
        registrar:
          type: string
          example: reserved-internet assigned numbers authority
        registrar_url:
          type: string
          description: URL of the domain registrar.
          example: http://res-dom.iana.org
        whois_server:
          type: string
          description: WHOIS server used for the query.
          example: whois.iana.org
        updated_date:
          type: array
          items:
            type: integer
            format: unix-time
          description: When the domain was last updated, as Unix timestamps, oldest first. Usually one value; some registries report more than one.
          example:
          - 1628924504
        creation_date:
          type: array
          items:
            type: integer
            format: unix-time
          description: When the domain was created, as Unix timestamps, oldest first. Usually one value.
          example:
          - 808372800
        expiration_date:
          type: array
          items:
            type: integer
            format: unix-time
          description: When the domain expires, as Unix timestamps, oldest first. Usually one value; some registries report more than one.
          example:
          - 1660363200
        name_servers:
          type: array
          items:
            type: string
          example:
          - a.iana-servers.net
          - b.iana-servers.net
        dnssec:
          type: string
          example: signeddelegation
        emails:
          type: string
          description: Contact email(s) from the WHOIS record. Returned only for some TLDs (e.g.org); not present for.com.
          example: cbath@pir.org
        is_eu:
          type:
          - boolean
          - 'null'
          description: Whether the registrant country is an EU member state.
        is_eea:
          type:
          - boolean
          - 'null'
          description: Whether the registrant country is in the European Economic Area.
        is_sepa:
          type:
          - boolean
          - 'null'
          description: Whether the registrant country is in the Single Euro Payments Area.
        registrant_privacy:
          type:
          - boolean
          - 'null'
          description: Premium (paid plans only). Whether the registrant's identity is hidden.
          example: false
        registrant_org:
          type: string
          description: Premium (paid plans only). The organisation that owns the domain, in its original casing.
          example: Google LLC
        privacy_service:
          type: string
          description: Premium (paid plans only). Name of the privacy or proxy provider standing in for the registrant.
          example: Domains By Proxy, LLC
        registrant_country:
          type: string
          description: Premium (paid plans only). Registrant country as an ISO 3166-1 alpha-2 code.
          example: US
        registrant_state:
          type: string
          description: Premium (paid plans only). Registrant state or province.
          example: CA
        registrant_name:
          type: string
          description: Premium (paid plans only). The individual registrant's name.
          example: Jane Roe
    WhoisOpenapi_ErrorResponse:
      type: object
      properties:
        message:
          type: string
        code:
          type: integer
  parameters:
    WhoisOpenapi_domain:
      name: domain
      in: query
      description: Valid domain to check (e.g. example.com). For top-level domains other than .com, a premium subscription is required.
      required: true
      schema:
        type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api