> ## Documentation Index
> Fetch the complete documentation index at: https://www.charitystack.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# GET /v1/contacts/{id} — retrieve a contact record
> Fetch a single contact by its unique ID, returning all stored fields including emails, phones, addresses, and lifetime giving totals.
The Get Contact endpoint retrieves a single contact record by its unique identifier. The contact must belong to your merchant account — attempting to fetch a contact owned by another merchant returns `403 Forbidden`. Use [List Contacts](/docs/api/contacts/list) to discover contact IDs.
## Endpoint
```
GET https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/contacts/{id}
```
## Authentication
Bearer token using your API key. Format: `Bearer cs_live_your_key`
## Path parameters
The unique identifier of the contact (UUID format).
## Response
On success the endpoint returns a single Contact object directly (not wrapped in an array).
Unique identifier for the contact.
Contact's first name.
Contact's last name.
Full name derived from `firstName` and `lastName`.
Organization or company name, if provided.
List of email address objects.
The email address.
Whether this is the primary email.
List of phone number objects.
The phone number (E.164, e.g. `+34613628904`; legacy rows may carry older formats).
Whether this is the primary phone.
List of address objects.
Street address line 1.
Street address line 2.
City.
State or region code (e.g., `MA`).
Postal or ZIP code.
Country name.
Whether this is the primary address.
Lifetime number of transactions associated with this contact.
Lifetime total transaction value in dollars.
`SUBSCRIBED`, `UNSUBSCRIBED`, `NEVER_SUBSCRIBED` or `UNKNOWN`. Always
present — derived server-side with suppression rules applied, so a contact
the platform will not send to never reads as subscribed.
Same enum and derivation rules as `emailConsent`. SMS is an opt-in regime.
Master consent flag, derived alongside the channel enums.
Read-only. Computed giving status — e.g. `new_donor`, `repeat_donor`,
`active_recurring`, `churned_recurring`.
Read-only. Whether the contact has an active recurring subscription.
Read-only. Gave last year but not this year.
Read-only. ISO timestamp of the first donation.
Read-only. ISO timestamp of the most recent donation.
Read-only via this API — tags are managed in the CharityStack dashboard.
Read-only. The contact chose to donate anonymously.
The analytics fields above (`donor_status`, `has_active_subscription`,
`is_lybunt`, `first_donation_at`, `last_donation_at`, `tags`,
`anonymousDonation`) are computed by CharityStack. Sending any of them to
[Update Contact](/docs/api/contacts/update) or
[Create Contact](/docs/api/contacts/create) returns `400 validation_failed` —
they can never be edited through the public API.
ISO 8601 timestamp of when the contact was created.
ISO 8601 timestamp of the most recent update.
## Status codes
| Code | Description |
| ----- | ---------------------------------------- |
| `200` | Contact returned successfully. |
| `401` | Missing or invalid API key. |
| `403` | Contact belongs to a different merchant. |
| `404` | No contact found with the given ID. |
## Example
```bash cURL theme={null}
curl https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/contacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer cs_live_your_key"
```
**200 response**
```json theme={null}
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"firstName": "Jane",
"lastName": "Smith",
"fullName": "Jane Smith",
"organizationName": "Smith Foundation",
"emails": [
{ "value": "jane@smithfoundation.org", "is_primary": true }
],
"phones": [
{ "value": "16175550101", "is_primary": true }
],
"addresses": [
{
"line1": "456 Park Ave",
"line2": "",
"city": "Boston",
"region": "MA",
"postal": "02101",
"country": "United States",
"is_primary": true
}
],
"totalTransactionCount": 12,
"totalTransactionValue": 3250.00,
"created_at": "2024-03-15T10:22:00.000000",
"updated_at": "2025-01-08T14:05:33.000000"
}
```