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

# List Domains

> List every custom domain registered for your organization with verification state.

Returns all custom domains for your organization, newest first — including each DNS check tracked during verification.

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token formatted as `Bearer gork_live_...`. Requires the `domains:read` scope.
</ParamField>

### Response

<ResponseField name="data" type="object[]">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique domain ID (`dom_...`).
    </ResponseField>

    <ResponseField name="domainName" type="string">
      The registered domain (e.g. `mail.acmecorp.com`).
    </ResponseField>

    <ResponseField name="status" type="string">
      Overall state: `pending`, `verified`, or `failed`.
    </ResponseField>

    <ResponseField name="mxStatus" type="boolean">
      Whether the inbound MX record check passes.
    </ResponseField>

    <ResponseField name="spfStatus" type="boolean">
      Whether the SPF record check passes.
    </ResponseField>

    <ResponseField name="dkimStatus" type="boolean">
      Whether the SES Easy-DKIM record checks pass.
    </ResponseField>

    <ResponseField name="dmarcStatus" type="boolean">
      Whether the DMARC record check passes.
    </ResponseField>

    <ResponseField name="verifiedAt" type="string">
      ISO 8601 timestamp of verification, or `null` while pending.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 creation timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.gork.email/v1/domains \
    -H "Authorization: Bearer gork_live_YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Gork } from "@gork/sdk"

  const gork = new Gork({ apiKey: process.env.GORK_API_KEY })

  const domains = await gork.domains.list()
  ```

  ```python Python theme={null}
  import requests, os

  res = requests.get(
      "https://api.gork.email/v1/domains",
      headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "dom_1a2b3c4d5e6f",
        "domainName": "mail.acmecorp.com",
        "status": "verified",
        "mxStatus": true,
        "spfStatus": true,
        "dkimStatus": true,
        "dmarcStatus": true,
        "verifiedAt": "2026-09-07T12:30:00.000Z",
        "createdAt": "2026-09-07T12:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  Run `POST /v1/domains/{id}/verify` to re-check DNS after adding the records from domain registration.
</Note>