> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendbaze.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List domains

> Newest first. Statuses are re-checked every five minutes while pending and daily once verified. Requires `read`.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/domains
openapi: 3.1.0
info:
  title: Sendbaze API
  version: '1.0'
  description: >
    Transactional email and SMS for Africa. Send from your own domain through
    Amazon SES in Cape Town.

    Every send returns an id immediately; delivery is reported by webhook and in
    the dashboard logs.
  contact:
    name: Sendbaze support
    email: support@sendbaze.com
    url: https://www.sendbaze.com
servers:
  - url: https://api.sendbaze.com
security:
  - bearerAuth: []
tags:
  - name: Emails
  - name: Templates
  - name: Domains
  - name: Suppressions
  - name: Webhooks
  - name: SMS
  - name: Usage
paths:
  /v1/domains:
    get:
      tags:
        - Domains
      summary: List domains
      description: >-
        Newest first. Statuses are re-checked every five minutes while pending
        and daily once verified. Requires `read`.
      operationId: listDomains
      responses:
        '200':
          description: Domains
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Domain'
components:
  schemas:
    Domain:
      type: object
      required:
        - id
        - name
        - status
        - mailFromDomain
        - records
        - verifiedAt
        - lastCheckedAt
        - createdAt
      properties:
        id:
          type: string
          example: dom_01j9x7k2r4m8q3v5n6b7c8d9e0
        name:
          type: string
          example: yourshop.co.za
        status:
          type: string
          enum:
            - pending
            - verified
            - failed
        mailFromDomain:
          type: string
          example: mail.yourshop.co.za
        records:
          type: array
          items:
            $ref: '#/components/schemas/DnsRecord'
        advice:
          type: array
          description: >-
            Deliverability findings from the last check (DMARC, apex SPF,
            alignment).
          items:
            $ref: '#/components/schemas/DomainAdvice'
        verifiedAt:
          type:
            - string
            - 'null'
          format: date-time
        lastCheckedAt:
          type:
            - string
            - 'null'
          format: date-time
        createdAt:
          type: string
          format: date-time
    DnsRecord:
      type: object
      required:
        - purpose
        - type
        - name
        - value
        - required
        - status
        - found
        - checkedAt
      properties:
        purpose:
          type: string
          enum:
            - dkim
            - mail_from_mx
            - mail_from_spf
            - dmarc
        type:
          type: string
          enum:
            - CNAME
            - MX
            - TXT
        name:
          type: string
          example: abc123._domainkey.yourshop.co.za
        value:
          type: string
          example: abc123.dkim.af-south-1.amazonses.com
        required:
          type: boolean
          description: >-
            Sending is blocked until every required record verifies; DMARC is
            advice.
        status:
          type: string
          enum:
            - pending
            - verified
            - failed
        found:
          type: array
          description: What public DNS currently returns for the name.
          items:
            type: string
        wildcard:
          type: boolean
          description: >-
            The answer comes from a wildcard record; publishing the exact record
            overrides it.
        checkedAt:
          type:
            - string
            - 'null'
          format: date-time
    DomainAdvice:
      type: object
      required:
        - code
        - level
        - title
        - detail
      properties:
        code:
          type: string
          example: dmarc_missing
        level:
          type: string
          enum:
            - warn
            - info
        title:
          type: string
        detail:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API key from the dashboard. `sk_live_…` sends; `sk_test_…` validates
        and returns ids without sending.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.