Get contact details

GEThttps://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

idstringrequired

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

Response

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

Show response fields

contactTypestring

createdAtstringdate-time

currencystring

emailstring

idstring

isActiveboolean

metadataobject

namestring

paymentTermsinteger

updatedAtstringdate-time

Error codes

400Invalid contact ID format.

404Contact not found.

RequestGET/v1/contacts/{id}curl

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

Response200

{
  "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"
  }
}