Docs
DashboardGet API key
API · contacts

List contacts

Return a page of the project's contacts. Filter by subscription state, search by email or name, and page forward with the cursor.

GET/v1/contacts

01 Query parameters

subscribedbooleanOptional
Filter by subscription state. Omit to return both.
qstringOptional
Search term matched against email and name.
cursorstringOptional
Opaque pagination cursor from a previous response's nextCursor.
limitintegerOptional
Page size, 1–100 (default 25).

02 Request

curl "https://api.drin.run/v1/contacts?subscribed=true&limit=50" \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

Returns 200 OK with a page under data. When nextCursor is non-null, pass it as cursor to fetch the next page. The SDK's paginate() iterator does this for you.

200 OK
{
  "data": [
    {
      "id": "ct_7Yh2Lp",
      "email": "ada@example.com",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "subscribed": true,
      "unsubscribedAt": null,
      "metadata": { "plan": "pro" },
      "createdAt": "2026-06-02T17:30:00.000Z",
      "updatedAt": "2026-06-02T17:30:00.000Z"
    }
  ],
  "nextCursor": "ct_7Yh2Lp"
}