Contacts
Get a contact
Retrieves a single contact by ID. Use the `include` parameter to embed related resources.
Authorization
apiKey AuthorizationBearer <token>
API key from your nodestash dashboard. Pass as a Bearer token in the Authorization header.
In: header
Path Parameters
id*string
Contact ID (prefixed with ct_).
Match
^ct_Query Parameters
include?string
Comma-separated list of related resources to include. Currently supported: company. When included, the contact attributes will contain a company object (or null).
Value in
"company"Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.nodestash.io/v1/contacts/ct_5hJ3kM9pQrVwXyZaB2cD4"{
"data": {
"id": "ct_5hJ3kM9pQrVwXyZaB2cD4",
"type": "contact",
"attributes": {
"id": "ct_5hJ3kM9pQrVwXyZaB2cD4",
"email": "jane@acme.com",
"first_name": "Jane",
"last_name": "Doe",
"phone": "+1-555-0100",
"company_id": "co_xyz789",
"title": "VP of Engineering",
"source": "website",
"custom_fields": {
"plan": "enterprise"
},
"tags": [
"vip",
"early-adopter"
],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-01-15T10:30:00Z"
}
},
"meta": {
"request_id": "req_abc123def456"
}
}{
"error": {
"code": "INVALID_API_KEY",
"message": "Missing or invalid Authorization header"
},
"meta": {
"request_id": "req_abc123def456"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
},
"meta": {
"request_id": "req_abc123def456"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded"
},
"meta": {
"request_id": "req_abc123def456"
}
}