---
title: "Get a contact"
method: GET
path: "/v1/contacts/{id}"
tags: ["Contacts"]
---

# Get a contact

`GET /v1/contacts/{id}`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/contacts/{id}`
- Auth: API key in header `x-api-key`

Returns a contact with its identities, profile, tags, and metadata.

## Path parameters

- `id` string, required

## Response `200`

Contact

- Contact
  - `id` string, required
  - `namespaceId` string, required
  - `name` string, required
  - `displayName` string, nullable, required
  - `avatar` string, nullable, required
  - `status` 'active' | 'paused' | 'blocked' | 'archived', required
  - `statusReason` string, nullable, required
  - `externalId` string, nullable, required
  - `identities` ContactIdentity[], required
    - `id` string, required
    - `type` 'email' | 'phone', required
    - `identifier` string, required
    - `verified` boolean, required
    - `channels` ContactIdentityChannel[], required
      - `channel` 'email', required
      - `reachability` 'unknown' | 'reachable' | 'unreachable', required
      - `consent` ContactConsent, required
        - `status` 'opted_in' | 'opted_out', required
        - `source` string, required
        - `capturedAt` string, required
        - `proof` JsonObject, required
  - `profile` ContactProfile, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `company` string, nullable
    - `jobTitle` string, nullable
    - `location` ContactLocation
      - `country` string, required
      - `state` string, required
      - `city` string, required
      - `timezone` string, required
    - `customFields` ContactCustomFields
    - `source` 'api' | 'import' | 'manual' | 'form', nullable
  - `preferences` ContactPreferences, required
    - `preferredChannels` string[], nullable
    - `language` string, nullable
    - `timezone` string, nullable
    - `notifications` object, nullable
      - `email` boolean, nullable
      - `quiet_hours` object, nullable
        - `start` string, required
        - `end` string, required
  - `tags` string[], required
  - `metadata` JsonObject, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `404`: ResourceNotFoundError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)