Retrieve a customer

Retrieve one AtomicPay customer by ID.

Last updated

Author: AtomicPay API

Authentication

Send your AtomicPay developer API key using Authorization: Bearer <API_KEY> or X-API-Key: <API_KEY>. This endpoint requires customers.read permission, unless the key has wildcard access (*).

Path parameters

id

Required. AtomicPay customer ID.

GET/v1/customers/:id

Base URL: https://api.atomicpay.com.br

Retrieve one AtomicPay customer by ID.

Request examples

curl

curl "https://api.atomicpay.com.br/v1/customers/cus_123" \
  -H "Authorization: Bearer {{api_key}}"

request.js

const response = await fetch('https://api.atomicpay.com.br/v1/customers/cus_123', {
  method: 'GET',
  headers: { Authorization: 'Bearer {{api_key}}' },
});

const data = await response.json();

Response

response.json

{
  "id": "cus_123",
  "object": "customer",
  "name": "Jenny Rosen",
  "email": "jenny@example.com",
  "document": "12345678900",
  "phone": "+5511999999999",
  "created_at": 1766400000000
}

List customers

Return customers visible to the authenticated account or product-scoped key.

List products

Return active products visible to the authenticated API key.