certdesk-dev Dns Info API

openapi: 3.2.0
info:
  title: certdesk Dns Info API
  version: 1.8.0
  description: 'TLS/SSL certificate diagnostics with a verdict: status OK | WARN | CRITICAL | UNKNOWN, judged from the certificate chain the server actually serves — measured from Korean point A (full chain, CRL revocation) plus point B and an overseas point on the Globalping public measurement network — verification, expiry, renewal point, revocation (CRL), chain, plus security grade, TLS error explanations and free expiry monitoring by email (double opt-in). If the server cannot be measured the status is UNKNOWN; CT logs are then shown only as an estimate and days left is null. No API key. Limit: 30 requests per minute per IP; results cached per domain for 10 minutes (security: 30 minutes). Free and best-effort. Docs: https://certdesk.dev/en/api/ · MCP server: https://certdesk.dev/mcp'
  contact:
    email: hello@certdesk.dev
    url: https://certdesk.dev/en/api/
servers:
- url: https://certdesk.dev/api/v1
tags:
- name: Dns Info
paths:
  /dns-info:
    get:
      operationId: dnsInfo
      summary: DNS and hosting facts for a domain
      description: Nameservers with DNS provider (only when the nameserver is under the provider's own domain), A/AAAA with IP owner (ASN via Team Cymru), CNAME, MX, CAA (effective record set, RFC 8659 tree climbing), SPF/DMARC, DNSSEC (DS at the zone apex), registrar and domain expiry (RDAP).
      parameters:
      - $ref: '#/components/parameters/domain'
      - $ref: '#/components/parameters/client'
      responses:
        '200':
          description: DNS facts
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  zone:
                    type: string
                  nameservers:
                    type: array
                    items:
                      type: object
                      properties:
                        host:
                          type: string
                        provider:
                          type:
                          - string
                          - 'null'
                  dnsProvider:
                    type:
                    - string
                    - 'null'
                  a:
                    type: array
                    items:
                      type: object
                      properties:
                        ip:
                          type: string
                        asn:
                          type: integer
                        asName:
                          type:
                          - string
                          - 'null'
                        prefix:
                          type: string
                        country:
                          type: string
                  aaaa:
                    type: array
                    items:
                      type: string
                  cname:
                    type: array
                    items:
                      type: string
                  mx:
                    type: array
                    items:
                      type: string
                  spf:
                    type:
                    - string
                    - 'null'
                  dmarc:
                    type:
                    - object
                    - 'null'
                  caa:
                    type:
                    - object
                    - 'null'
                    properties:
                      foundAt:
                        type: string
                      issue:
                        type: array
                        items:
                          type: string
                      issuewild:
                        type: array
                        items:
                          type: string
                      records:
                        type: array
                        items:
                          type: string
                  dnssec:
                    type: boolean
                  registrar:
                    type:
                    - string
                    - 'null'
                  domainExpiry:
                    type:
                    - string
                    - 'null'
        '400':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      tags:
      - Dns Info
components:
  responses:
    Error:
      description: Invalid input
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              code:
                type: string
                description: EMPTY, INVALID_DOMAIN, INVALID_PORT, PORT_UNSUPPORTED, IP_LITERAL, PRIVATE_ADDRESS (400); MEASURE_LIMIT, FRESH_LIMIT (429)
    RateLimited:
      description: More than 30 requests per minute from this IP
      headers:
        retry-after:
          schema:
            type: integer
  parameters:
    client:
      name: client
      in: query
      required: false
      description: Optional name of your app or tool, used only for aggregate usage counts
      schema:
        type: string
    domain:
      name: domain
      in: query
      required: true
      schema:
        type: string
        examples:
        - example.com