Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Retrieve a single contact, including custom fields
GET https://api.cortado.pro/api/v1/ext/contacts/{id}
curl -H "Authorization: Bearer cort_your_key_here" \
https://api.cortado.pro/api/v1/ext/contacts/c0ffee00-1111-2222-3333-444455556666
| Parameter | Type | Description |
|---|---|---|
id | UUID | The contact’s ID. Copy it from the contact’s URL in Cortado, or read contact_id from a lead. |
{
"id": "c0ffee00-1111-2222-3333-444455556666",
"organization_id": "3b1c9a2e-77d4-4c0b-9f61-2a5e8d3f4c11",
"first_name": "Ada",
"last_name": "Lovelace",
"email": "ada@example.com",
"phone_number": "+15135550142",
"custom_fields": {
"dietary_notes": "Vegetarian"
},
"archived_at": null,
"created_at": "2026-09-01T14:02:11Z",
"updated_at": "2026-09-03T09:45:00Z"
}
| Field | Type | Description |
|---|---|---|
id | string | The contact’s UUID |
organization_id | string | The organization the contact belongs to |
first_name | string | First name |
last_name | string | Last name |
email | string | null | Email address |
phone_number | string | null | Phone number |
custom_fields | object | Your organization’s custom fields. Omitted when the contact has none |
archived_at | string | null | When the contact was archived |
created_at | string | When the contact was created |
updated_at | string | When the contact was last changed |
custom_fields keys come from the custom fields your organization has defined. Adding or renaming a custom field in Cortado changes what appears here, so have your integration read fields by name rather than by position.| Status | error | Cause |
|---|---|---|
400 | invalid_id | {id} is not a valid UUID |
401 | missing_api_key / invalid_api_key | Missing, malformed, or revoked key |
403 | api_access_disabled | API access is off for the organization |
404 | not_found | No such contact, or it belongs to another organization |
429 | — | Rate limit exceeded |