Saltar al contenido principal
List Customers
curl --request GET \
  --url https://api.spherepay.co/v2/customer \
  --header 'Authorization: Bearer <token>'
{
  "customers": [
    {
      "id": "customer_f31121c389624d3697cbf3ea8830b7a4",
      "type": "individual",
      "email": "jane.smith@example.com",
      "phone": "+14155550123",
      "firstName": "Jane",
      "lastName": "Smith",
      "verificationProfiles": [
        {
          "name": "kyc_profile_a",
          "status": "incomplete",
          "criteria": {
            "complete": [
              "email_address",
              "phone_number",
              "residential_address",
              "tax_identification_number"
            ],
            "pending": [],
            "required": [
              "identity_document",
              "liveness_report_document"
            ],
            "errors": []
          }
        }
      ],
      "meta": {},
      "createdAt": "2026-03-09T20:46:31.305Z",
      "updatedAt": "2026-03-09T20:46:31.305Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}
Usa este endpoint para recuperar todos los clientes asociados a tu cuenta de SpherePay. Los resultados se devuelven en páginas, y puedes filtrar por estado o tipo de cliente para limitar la lista. Cada elemento en la respuesta incluye el perfil de verificación del cliente, para que puedas identificar rápidamente qué clientes están listos para transferencias.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de consulta

object
requerido

Respuesta

customers
(Individual · object | Business · object)[]
requerido

Array of customer objects

Response containing information about an individual customer.

pagination
object
requerido
Última modificación el 18 de junio de 2026