Get a customer
Get a customer by their ID. Returns the full customer object.
Authorizations
A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.
Path Parameters
The ID of the customer.
The ID of the Customer, which is a UUID prefixed by customer_.
^customer_[a-f0-9\-]{36}$"customer_af2937b0-9846-4fe7-bfe9-ccc22d935114"
Response
Successfully retrieved customer.
A customer record returned on read (Get / Create / Update Customer).
The ID of the Customer, which is a UUID prefixed by customer_.
^customer_[a-f0-9\-]{36}$"customer_af2937b0-9846-4fe7-bfe9-ccc22d935114"
The type of the Customer.
individual "individual"
Current state of each capability for this customer. Each capability shows whether it has been requested and its current status.
{
"custodyCrypto": { "requested": true, "status": "active" },
"custodyFiat": {
"requested": false,
"status": "unrequested"
},
"custodyStablecoin": {
"requested": false,
"status": "unrequested"
},
"tradeCrypto": {
"requested": false,
"status": "unrequested"
},
"tradeStablecoin": {
"requested": false,
"status": "unrequested"
},
"transferCrypto": { "requested": true, "status": "active" },
"transferFiat": {
"requested": false,
"status": "unrequested"
},
"transferStablecoin": {
"requested": false,
"status": "unrequested"
}
}Map of requirements to be submitted. Each key is the field name, with values to describe its state. Requirements are only shown for requested capabilities. When a requirement is fulfilled, it disappears from this map.
{
"firstName": {
"status": "due",
"impact": ["custodyCrypto", "transferCrypto"]
},
"fullSsn": {
"status": "rejected",
"impact": ["custodyCrypto"]
},
"ssnLast4": {
"status": "pending",
"impact": ["custodyCrypto"]
},
"sourceOfFunds": { "status": "due" },
"citizenship": { "status": "due" },
"tos": {
"status": "due",
"impact": ["transferFiat"],
"tosVersions": [
{
"versionId": "us_individual_2026-05-29",
"languages": ["en"],
"url": "https://docs.cdp.coinbase.com/legal/terms/us_individual_2026-05-29"
}
]
},
"taxAttestation": {
"status": "due",
"impact": ["transferFiat"],
"taxForms": ["us_w9"]
}
}Timestamp when the customer was created.
"2026-01-10T14:25:00Z"
Timestamp when the customer was last updated.
"2026-01-10T14:30:00Z"
Individual customer data returned on read — the individual object on
Get / Create / Update Customer responses. Only contact-identity fields are
echoed back; every other field accepted on the IndividualInput object
(address, ssnLast4, dateOfBirth, fullSsn, citizenship,
phoneNumber, and the CDD fields) is ingestion-only and never returned.
{
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com"
}The project IDs that this customer is associated with.
The ID of the Project, a UUID v4.
^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$[]Terms of Service acceptances recorded for the customer.
[
{
"versionId": "us_individual_2026-05-29",
"language": "en",
"acceptedAt": "2026-04-10T12:00:00Z"
}
]