> ## Documentation Index
> Fetch the complete documentation index at: https://usegately.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Contact

> Retrieve a single contact by ID

## Headers

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_API_KEY`
</ParamField>

<ParamField header="X-Project-ID" type="string">
  Your project UUID. Not required if the API key already encodes the project.
</ParamField>

## Path Parameters

<ParamField path="contactId" type="string" required>
  The contact UUID
</ParamField>

## Response

Returns a single contact object with resolved tags.

<ResponseField name="id" type="string">Unique contact identifier</ResponseField>
<ResponseField name="name" type="string">Full name</ResponseField>
<ResponseField name="email" type="string">Email address</ResponseField>
<ResponseField name="phone" type="string">Phone number</ResponseField>
<ResponseField name="company" type="string">Company name</ResponseField>
<ResponseField name="status" type="string">`new` · `active` · `inactive` · `archived`</ResponseField>
<ResponseField name="notes" type="string">Internal notes</ResponseField>
<ResponseField name="custom_fields" type="object">Key-value custom field data</ResponseField>
<ResponseField name="unsubscribed" type="boolean">Whether the contact has unsubscribed from emails</ResponseField>
<ResponseField name="tags" type="ContactTag[]">Resolved tag objects</ResponseField>
<ResponseField name="last_contacted_at" type="string">ISO 8601 timestamp of last contact</ResponseField>
<ResponseField name="created_at" type="string">ISO 8601 creation timestamp</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.usegately.com/api/v1/contacts/CONTACT_ID" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "X-Project-ID: YOUR_PROJECT_ID"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch('https://api.usegately.com/api/v1/contacts/CONTACT_ID', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'X-Project-ID': 'YOUR_PROJECT_ID',
    }
  })
  const contact = await res.json()
  ```

  ```typescript SDK theme={null}
  import { GatelyContacts } from '@gately/sdk'

  const crm = new GatelyContacts({ projectId: 'YOUR_PROJECT_ID' })
  const contact = await crm.get('CONTACT_ID')
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "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"
  }
  ```

  ```json Not found theme={null}
  {
    "error": "Contact not found"
  }
  ```
</ResponseExample>
