403 Forbidden. Use List Contacts to discover contact IDs.
The fields below are the complete public contact object. CharityStack stores additional internal fields on a contact for its own bookkeeping; those are deliberately not part of this API and will never appear in a response. New fields may be added here over time, so parse defensively and ignore anything you do not recognize.
Endpoint
Authentication
Path parameters
Response
On success the endpoint returns a single Contact object directly (not wrapped in an array).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.ISO 8601 timestamp of when the contact was created. Absent for contacts
created before CharityStack began recording this, which is most historical
contacts — treat it as optional.
The giving fields (
totalTransactionValue, totalTransactionCount,
hasActiveSubscription, firstDonationAt, lastDonationAt) are computed by
CharityStack. Sending any of them to
Update Contact or
Create Contact returns 400 validation_failed —
they can never be edited through the public API.Status codes
Example
cURL