Get contact details

GET https://app.speybooks.com/api/v1/contacts/{id}

Retrieves a single contact by prefixed ID, including all fields: identity, address, banking details, defaults, metadata, and timestamps.

Path parameters

id string required

Contact ID (e.g. cont_3). Must use the contact prefix.

Response

200 Returns full contact details including address, bank details, metadata, and payment terms.

Show response fields

contactType string

createdAt string date-time

currency string

email string

id string

isActive boolean

metadata object

name string

paymentTerms integer

updatedAt string date-time

Error codes

400 Invalid contact ID format.

404 Contact not found.

Request GET /v1/contacts/{id} curl

curl https://api.speybooks.com/v1/contacts/cont_3 \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "id": "cont_3",
    "contactType": "customer",
    "name": "Highland Web Services Ltd",
    "email": "accounts@highlandweb.scot",
    "paymentTerms": 30,
    "currency": "GBP",
    "isActive": true,
    "metadata": {},
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-02-01T14:22:00.000Z"
  }
}