Retrieve a contact

GET/v1/contacts/{id}API key

Returns one contact from the project. To find a contact by email, use List contacts with q.

Path parameters

idstringpathrequired

The contact ID, for example ct_01K6C1M3R8T2V9X4Z6B7N5P0QA.

Response

The contact, with the fields described in Create a contact.

Errors

Status	Code	When
404	`contact_not_found`	No contact with that ID in this project.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const contact = await flaresend.contacts.get('ct_01K6C1M3R8T2V9X4Z6B7N5P0QA');

Response

{
  "id": "ct_01K6C1M3R8T2V9X4Z6B7N5P0QA",
  "projectId": "proj_01K5Z8W2Q4R6T8V0X2Z4B6D8FG",
  "email": "ada@example.com",
  "firstName": "Ada",
  "lastName": "Lovelace",
  "unsubscribed": false,
  "data": { "plan": "pro" },
  "createdAt": "2026-09-26T10:00:00.000Z",
  "updatedAt": "2026-09-26T10:00:00.000Z"
}

Path parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Response

Errors