Skip to main content
GET
/
api
/
v1
/
cardholders
/
{id}
curl https://api.agentcard.sh/api/v1/cardholders/ch_abc123 \
  -H "Authorization: Bearer sk_test_..."

{
  "id": "ch_abc123",
  "firstName": "Alice",
  "lastName": "Smith",
  "email": "alice@example.com",
  "dateOfBirth": "1990-01-15T00:00:00.000Z",
  "phoneNumber": null,
  "createdAt": "2026-03-10T12:00:00.000Z",
  "updatedAt": "2026-03-10T12:00:00.000Z"
}
Returns a single cardholder by their unique identifier.

​
Path parameters

​
id
string
required
The cardholder’s unique identifier.

​
Response

​
id
string
Unique cardholder identifier.
​
firstName
string
Cardholder’s first name.
​
lastName
string
Cardholder’s last name.
​
email
string
Cardholder’s email address, if provided.
​
dateOfBirth
string
Date of birth, if provided.
​
phoneNumber
string
Phone number, if provided.
​
createdAt
string
ISO 8601 creation timestamp.
​
updatedAt
string
ISO 8601 last-updated timestamp.
curl https://api.agentcard.sh/api/v1/cardholders/ch_abc123 \
  -H "Authorization: Bearer sk_test_..."

{
  "id": "ch_abc123",
  "firstName": "Alice",
  "lastName": "Smith",
  "email": "alice@example.com",
  "dateOfBirth": "1990-01-15T00:00:00.000Z",
  "phoneNumber": null,
  "createdAt": "2026-03-10T12:00:00.000Z",
  "updatedAt": "2026-03-10T12:00:00.000Z"
}