# Get a contact

`GET /v1/contacts/{id}`

Fetches a contact by its ID.

Needs `contacts:read`.

## Path parameters

- `id` (string, uuid): The contact's ID.

## Example

```sh
curl https://app.soosh.io/v1/contacts/4ea0d485-435d-407f-837a-c7d67095f23a \
  -H "Authorization: Bearer $SOOSH_API_KEY"
```

Response 200:

```json
{
  "id": "4ea0d485-435d-407f-837a-c7d67095f23a",
  "phone": "+919876543210",
  "whatsapp_user_id": null,
  "name": "Priya Sharma",
  "whatsapp_name": "Priya S",
  "attributes": {
    "customer_id": "8812",
    "city": "Pune",
    "orders": 3
  },
  "tags": [
    "VIP"
  ],
  "marketing_opt_out": false,
  "number_id": "0f6d3c1e-5b7a-4c52-9a55-3f6a2d5c8b10",
  "chat": {
    "status": "open",
    "assigned_agent_id": "5b1d7d0e-3c2a-4f61-9a0e-6f8f3b2c1d40",
    "last_message_at": "2026-10-14T09:30:12.481Z",
    "last_inbound_at": "2026-10-14T09:12:40.117Z"
  },
  "created_at": "2026-10-14T09:05:11.420Z",
  "updated_at": "2026-10-14T09:30:12.481Z"
}
```

## Returns

200. The contact.

## Errors

Besides the ones every request can get (https://docs.soosh.io/reference/api/errors/):

- 404 `not_found`: There is no contact with this ID in your workspace.