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

# Domain information

> Retrieve domain associated with the tenant

Retrieve the domains associated with your tenant, including verification status, DNS records, and sending configuration.

### Features

* View domain verification status
* Check domain configuration details
* Get DNS records information
* Monitor domain activity status

### Query parameters

All optional — used for pagination and sorting.

| Parameter          | Type    | Description                                                                     |
| ------------------ | ------- | ------------------------------------------------------------------------------- |
| `skip`             | integer | Records to skip (pagination offset)                                             |
| `take`             | integer | Max records to return (pagination limit)                                        |
| `orderBy`          | string  | Sort order, e.g. `{ "updatedAt": "desc" }`. Defaults to `updatedAt` descending. |
| `onboardingStatus` | boolean | Filter by onboarding status                                                     |

### Response

Returns `{ domains: [...], count }`. Each domain includes `isActive`, `isApproved`, `isVerified`, `dnsRecords`, plus `lastVerificationErrors` and `lastVerificationCheckedAt` from the most recent verification check.

* `200 OK`: List of domains retrieved successfully
* `401 Unauthorized`: Invalid API key

<Note>
  No request body is required. Provide the API key in the `Authorization` header.
</Note>


## OpenAPI

````yaml GET /v2/domain
openapi: 3.1.0
info:
  title: Email Service API
  description: API for sending and managing email communications
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sending.sendrapp.org
    description: Email Sending API
  - url: https://stats.sendrapp.org
    description: Statistics API
  - url: https://logs.sendrapp.org
    description: Logs API
  - url: http://localhost:3001
    description: Local Development
security:
  - apiKeyAuth: []
paths:
  /v2/domain:
    get:
      summary: Tenant Domain
      description: Retrieve domain associated with the tenant
      parameters:
        - name: skip
          in: query
          required: false
          schema:
            type: integer
          description: Number of records to skip (pagination offset)
        - name: take
          in: query
          required: false
          schema:
            type: integer
          description: Maximum number of records to return (pagination limit)
        - name: orderBy
          in: query
          required: false
          schema:
            type: string
          description: >-
            Sort order, e.g. { "updatedAt": "desc" }. Defaults to updatedAt
            descending.
        - name: onboardingStatus
          in: query
          required: false
          schema:
            type: boolean
          description: Filter by onboarding status
      responses:
        '200':
          description: List of domains retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainListResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      servers:
        - url: https://platform.sendr.app/api
          description: API Server
        - url: http://localhost:3001
          description: Local Development
components:
  schemas:
    DomainListResponse:
      type: object
      properties:
        domains:
          type: array
          items:
            $ref: '#/components/schemas/Domain'
        count:
          type: integer
          description: Total number of domains
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
          format: int32
          description: Error code
        message:
          type: string
          description: Error message
    Domain:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Domain identifier
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp
        name:
          type: string
          description: Domain name
        description:
          type:
            - string
            - 'null'
          description: Domain description
        sendingEmail:
          type: string
          format: email
          description: Default sending email address
        dnsRecords:
          type: array
          description: DNS records for domain verification
          items:
            type: object
        isActive:
          type: boolean
          description: Whether the domain is active
        isApproved:
          type: boolean
          description: Whether the domain is approved
        isVerified:
          type: boolean
          description: Whether the domain is verified
        lastVerificationErrors:
          type:
            - array
            - 'null'
          description: >-
            Errors from the most recent verification check, or null if the last
            check passed
          items:
            type: object
        lastVerificationCheckedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: Timestamp of the most recent verification check
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````