Skip to main content
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 to discover contact IDs.

​
Endpoint

GET https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/contacts/{id}

​
Authentication

​
Authorization
string
required
Bearer token using your API key. Format: Bearer cs_live_your_key

​
Path parameters

​
id
string
required
The unique identifier of the contact (UUID format).

​
Response

On success the endpoint returns a single Contact object directly (not wrapped in an array).
​
id
string
Unique identifier for the contact.
​
firstName
string
Contact’s first name.
​
lastName
string
Contact’s last name.
​
fullName
string
Full name derived from firstName and lastName.
​
organizationName
string
Organization or company name, if provided.
​
emails
object[]
List of email address objects.
​
phones
object[]
List of phone number objects.
​
addresses
object[]
List of address objects.
​
totalTransactionCount
number
Lifetime number of transactions associated with this contact.
​
totalTransactionValue
number
Lifetime total transaction value in dollars.
​
created_at
string
ISO 8601 timestamp of when the contact was created.
​
updated_at
string
ISO 8601 timestamp of the most recent update.

​
Status codes

CodeDescription
200Contact returned successfully.
401Missing or invalid API key.
403Contact belongs to a different merchant.
404No contact found with the given ID.

​
Example

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