Domain Lab Registrar Connections API

openapi: 3.2.0
info:
  title: Domain Lab Registrar Connections API
  version: 1.0.0
  description: 'REST API for Domain Lab, a domain-monitoring service. Query monitored domains, plan limits and usage, per-domain alert settings, AI reviews, registrar connections, WHOIS/registration data, SSL certificates, DNS records, email security (SPF, DKIM, DMARC, MTA-STS, TLS reporting, BIMI, DNSSEC) with grades and history, change events, and alert history; add, update, and remove monitored domains. Requires an active subscription or trial. Limits: 120 requests/minute, 50,000 requests/month (adding a domain, rescanning, running an AI review and syncing a registrar connection each count as 5). Every response carries X-RateLimit-Remaining-Minute and X-RateLimit-Remaining-Month headers.'
  contact:
    url: https://www.domainlab.app/help
servers:
- url: https://www.domainlab.app/api/v1
security:
- apiKey: []
tags:
- name: Registrar Connections
paths:
  /registrar-connections:
    get:
      operationId: listRegistrarConnections
      summary: Connected registrar accounts (credentials are never returned)
      responses:
        '200':
          description: Registrar connections
          content:
            application/json:
              schema:
                type: object
                properties:
                  connections:
                    type: array
                    items:
                      $ref: '#/components/schemas/RegistrarConnection'
        '401':
          description: Missing or invalid API key
        '403':
          description: Account lacks API access (no active subscription or trial)
        '429':
          description: Rate limit or monthly quota exceeded. Respect the Retry-After header. code is RATE_LIMITED (short-lived) or MONTHLY_QUOTA_EXCEEDED (resets next period).
      tags:
      - Registrar Connections
  /registrar-connections/{id}/sync:
    post:
      operationId: syncRegistrarConnection
      summary: Sync a registrar connection now (counts as 5 requests)
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
        description: Registrar connection id (find it via GET /registrar-connections)
      responses:
        '200':
          description: '{ connection_id, provider, last_sync_status, last_sync_summary, last_synced_at }'
        '401':
          description: Missing or invalid API key
        '403':
          description: Account lacks API access (no active subscription or trial)
        '404':
          description: NOT_FOUND
        '429':
          description: Rate limit or monthly quota exceeded. Respect the Retry-After header. code is RATE_LIMITED (short-lived) or MONTHLY_QUOTA_EXCEEDED (resets next period).
        '502':
          description: REGISTRAR_SYNC_FAILED
      tags:
      - Registrar Connections
components:
  schemas:
    RegistrarConnection:
      type: object
      properties:
        id:
          type: integer
        provider:
          type: string
        label:
          type:
          - string
          - 'null'
        auto_add:
          type: boolean
        last_synced_at:
          type:
          - string
          - 'null'
          format: date-time
        last_sync_status:
          type:
          - string
          - 'null'
        last_sync_error:
          type:
          - string
          - 'null'
        last_sync_summary:
          type:
          - object
          - 'null'
        created_at:
          type: string
          format: date-time
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'Domain Lab API key (dlb_...), created in Preferences → API. Send as: Authorization: Bearer dlb_...'