v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBRetrieve a customer
Retrieves the details of one of your customers.
Path parameters
Query parameters
Resolve a customer owned by a sibling partner in the same organization (PII opt-in). Defaults to false; a customer owned by another partner returns 404 unless this is true and the caller shares an organization with the owner. The owner is named on the response's owner_partner_id, and a sibling-owned customer's metadata is returned as null.
Resolve a customer owned by a sibling partner in the same organization (PII opt-in). Defaults to false; a customer owned by another partner returns 404 unless this is true and the caller shares an organization with the owner. The owner is named on the response's owner_partner_id, and a sibling-owned customer's metadata is returned as null.
Response
An envelope wrapping a single customer object.
Example response
{
"customer": {
"customer_id": "fcus_01HACM7FZ1084XB1GB6053VM0D",
"owner_partner_id": "obj_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"first_name": "John",
"last_name": "Doe",
"email": "joh.doe@example.com",
"phone": "+15555555555",
"employer": "Flex",
"shipping": {},
"metadata": {
"order_id": "8842",
"channel": "shopify"
},
"created_at": "2026-06-15T14:30:00Z",
"test_mode": false
}
}