Docs
DashboardGet API key
API · contacts

Retrieve a contact

Fetch one contact by id, with its full name, subscription state, timestamps, and stored metadata.

GET/v1/contacts/{id}

01 Path parameters

idstringRequired
The contact id, e.g. ct_7Yh2Lp.

02 Request

curl https://api.drin.run/v1/contacts/ct_7Yh2Lp \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

Returns 200 OK with the contact. An id that is unknown or not visible to this project returns 404 not_found.

200 OK
{
  "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"
}