Skip to main content
Use this endpoint to fetch the full record of a single customer by their UUID. This is useful when you need to verify a customer’s details before processing an order, display buyer information in your dashboard, or confirm that a registration was saved correctly. Pass the customer UUID in the URL path where {id} appears.

​
Request

​
X-Api-Key
string
required
Your CertoPay secret API key. Include it in every request as X-Api-Key: sk_live_sua_chave_aqui.
​
id
string
required
The UUID of the customer to retrieve. This is the id returned when the customer was created via POST /api/customers.
This endpoint accepts no request body.

​
Response

A successful request returns HTTP 200 OK with the full customer object.
​
id
string
Unique UUID identifying the customer.
​
name
string
Full name of the customer.
​
email
string
Email address of the customer.
​
document
string
CPF number (11 digits) of the customer.
​
phone
string
Phone number of the customer.
​
createdAt
string
ISO 8601 timestamp of when the customer record was created.

​
Example

curl https://v2.certopaybrasil.com/api/customers/uuid-do-customer \
  -H "X-Api-Key: sk_live_sua_chave_aqui"
200 OK
{
  "id": "uuid-do-customer",
  "name": "João da Silva",
  "email": "joao@email.com",
  "document": "12345678900",
  "phone": "(11) 99999-9999",
  "createdAt": "2026-06-26T10:00:00Z"
}