Get a contact
Returns one contact.
GET
/v1/contacts/:id
Permission
The key must be granted contacts.read
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Path parameters
| Field | Type | Description |
|---|---|---|
id required |
string | The contact to read. |
Request
curl https://api.veruapis.com/v1/contacts/:id \
-H "Authorization: Bearer vak_live_..."Response
| Field | Type | Description |
|---|---|---|
id |
string | |
address_book_id |
string | Which book holds it. |
name |
string | The display name. Core calls this formatted_name; it is name here, because that is what every other resource in this API calls the human-readable string. |
given_name |
string | |
family_name |
string | |
emails |
object[] | Addresses, in stored order. The first is the one to compose to. Its fields are below. |
phones |
object[] | Numbers, in stored order. Its fields are below. |
organization |
string | |
title |
string | Their job title, not a name prefix. |
notes |
string | |
created_at |
RFC 3339 | |
updated_at |
RFC 3339 |
Each item in emails
| Field | Type | Description |
|---|---|---|
address required |
string | |
type |
string | A label such as work or home. Free text, not a closed set. |
Each item in phones
| Field | Type | Description |
|---|---|---|
number required |
string | |
type |
string | A label such as cell or work. |
{
"data": {
"id": "01918e4b-2101-7f11-b4a9-0242ac130003",
"address_book_id": "01918e4b-2002-7f11-b4a9-0242ac130003",
"name": "Bob Smith",
"emails": [ { "address": "[email protected]", "type": "work" } ],
"phones": [ { "number": "+37060000000", "type": "cell" } ],
"organization": "Example Ltd",
"created_at": "2026-05-20T12:00:00Z",
"updated_at": "2026-05-20T14:22:00Z"
},
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" }
}
Worth knowing
Empty fields are omitted rather than returned as empty strings, so absence means nothing was stored.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Create a contact
- DELETE Delete a contact
- GET List address books
- GET List contacts
- PATCH Update a contact