Skip to main content
GET
/
api
/
v1
/
contacts
/
{contactId}
curl "https://api.usegately.com/api/v1/contacts/CONTACT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Project-ID: YOUR_PROJECT_ID"

{
  "id": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
  "project_id": "proj-uuid-here",
  "name": "Jane Smith",
  "email": "jane@example.com",
  "phone": "+1 555 000 1234",
  "company": "Acme Corp",
  "status": "active",
  "notes": "Met at SaaStr 2025",
  "custom_fields": { "plan": "pro", "source": "webinar" },
  "unsubscribed": false,
  "tags": [
    { "id": "tag-uuid", "name": "VIP", "color": "#ff6600", "created_at": "2025-01-01T00:00:00.000Z" }
  ],
  "last_contacted_at": "2025-05-10T09:00:00.000Z",
  "created_at": "2025-01-15T12:00:00.000Z",
  "updated_at": "2025-05-10T09:00:00.000Z"
}

​
Headers

​
Authorization
string
required
Bearer YOUR_API_KEY
​
X-Project-ID
string
Your project UUID. Not required if the API key already encodes the project.

​
Path Parameters

​
contactId
string
required
The contact UUID

​
Response

Returns a single contact object with resolved tags.
​
id
string
Unique contact identifier
​
name
string
Full name
​
email
string
Email address
​
phone
string
Phone number
​
company
string
Company name
​
status
string
new · active · inactive · archived
​
notes
string
Internal notes
​
custom_fields
object
Key-value custom field data
​
unsubscribed
boolean
Whether the contact has unsubscribed from emails
​
tags
ContactTag[]
Resolved tag objects
​
last_contacted_at
string
ISO 8601 timestamp of last contact
​
created_at
string
ISO 8601 creation timestamp
curl "https://api.usegately.com/api/v1/contacts/CONTACT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Project-ID: YOUR_PROJECT_ID"

{
  "id": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
  "project_id": "proj-uuid-here",
  "name": "Jane Smith",
  "email": "jane@example.com",
  "phone": "+1 555 000 1234",
  "company": "Acme Corp",
  "status": "active",
  "notes": "Met at SaaStr 2025",
  "custom_fields": { "plan": "pro", "source": "webinar" },
  "unsubscribed": false,
  "tags": [
    { "id": "tag-uuid", "name": "VIP", "color": "#ff6600", "created_at": "2025-01-01T00:00:00.000Z" }
  ],
  "last_contacted_at": "2025-05-10T09:00:00.000Z",
  "created_at": "2025-01-15T12:00:00.000Z",
  "updated_at": "2025-05-10T09:00:00.000Z"
}