List domains

Page through every domain registered for the project, newest first. Filter by verification status to find what’s still pending. GET /v1/domains Returns a cursor page of domains. The list omits per-record deliverability detail; fetch a single domain with retrieve for its full records and auth health.

Query parameters

string

Filter by verification status — one of pending, verified, or failed.

integer

Page size, 1–100. Defaults to 25.

string

The nextCursor from a previous response. Omit for the first page.

Request

curl "https://api.drin.run/v1/domains?status=verified&limit=25" \
  -H "Authorization: Bearer $DRIN_API_KEY"

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const { data, nextCursor } = await drin.domains.list({ status: "verified" });

for (const domain of data) {
  console.log(domain.domain, domain.status);
}

Response

200 OK — a page of domains. When nextCursor is null you’ve reached the end. See Pagination for the full walk.

{
  "data": [
    {
      "id": "dom_01HZ8K3M9P",
      "domain": "mail.acme.com",
      "status": "verified",
      "records": [ /* … */ ],
      "createdAt": "2026-05-30T11:04:00Z"
    }
  ],
  "nextCursor": null
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

List domains

Query parameters

Request

Response

​Query parameters

​Request

​Response

Query parameters

Request

Response