Skip to main content
GET
/
api
/
v1
/
contact-lists
/
{listId}
/
contacts
/
{id}
Get Contact
curl --request GET \
  --url https://api.example.com/api/v1/contact-lists/{listId}/contacts/{id}
{
  "id": "<string>",
  "email": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "phoneNumber": "<string>",
  "customFields": {},
  "status": "<string>",
  "source": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "subscribedAt": "<string>",
  "unsubscribedAt": "<string>",
  "consentType": "<string>",
  "consentSource": "<string>",
  "consentTimestamp": "<string>",
  "consentIpAddress": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt

Use this file to discover all available pages before exploring further.

Get detailed information about a specific contact by its ID.

​
Path Parameters

​
listId
string
required
The unique list ID (e.g., lst_abc123).
​
id
string
required
The unique contact ID (e.g., cnt_abc123).

​
Examples

import { MailBreeze } from "mailbreeze";

const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });
const contacts = mailbreeze.contacts("lst_abc123");

const contact = await contacts.get("cnt_abc123");

console.log(contact.email);        // "john@example.com"
console.log(contact.status);       // "active"
console.log(contact.customFields); // { plan: "pro", company: "Acme" }

​
Response

​
id
string
Unique contact ID.
​
email
string
Contact’s email address.
​
firstName
string
Contact’s first name.
​
lastName
string
Contact’s last name.
​
phoneNumber
string
Contact’s phone number.
​
customFields
object
Custom field values.
​
status
string
Contact status: active, unsubscribed, bounced, complained, or suppressed.
​
source
string
Acquisition source.
​
createdAt
string
ISO 8601 timestamp when created.
​
updatedAt
string
ISO 8601 timestamp when last updated.
​
subscribedAt
string
ISO 8601 timestamp when subscribed.
​
unsubscribedAt
string
ISO 8601 timestamp when unsubscribed (if applicable).
​
consentType
string
Type of consent: explicit, implicit, or legitimate_interest.
​
consentSource
string
Where consent was collected.
​
consentTimestamp
string
ISO 8601 timestamp when consent was given.
​
consentIpAddress
string
IP address from which consent was given.
Example Response
{
  "success": true,
  "data": {
    "id": "8f1701be-0d2a-4519-999c-0574a3d68668",
    "domainId": "6911cf4253eb3ff3b4de6215",
    "contactListId": "694fc1669e63563857ae8d72",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "customFields": {},
    "status": "active",
    "source": "console",
    "subscriptionToken": "b839501cb01ca878a01bd2d8d947ad3350b53afbf5370d3b3e1999c958ce309a",
    "createdAt": "2025-12-27T12:36:25.458Z",
    "updatedAt": "2025-12-27T12:36:26.851Z"
  },
  "meta": {
    "timestamp": "2025-12-27T13:45:00.000Z",
    "requestId": "abc123-def456",
    "path": "/api/v1/contact-lists/694fc1669e63563857ae8d72/contacts/8f1701be-0d2a-4519-999c-0574a3d68668"
  }
}

​
Errors

CodeHTTP StatusDescription
CONTACT_NOT_FOUND404Contact with this ID doesn’t exist
LIST_NOT_FOUND404List with this ID doesn’t exist