curl --request GET \
  --url https://sandbox-api.sakawave.example/v1/customers \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.sakawave.example/v1/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox-api.sakawave.example/v1/customers"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "id": "01K2Z3AB4C5D6E7F8G9HJKMNPQ",
      "type": "individual",
      "jurisdiction": "NG",
      "externalReference": "cust_1001",
      "displayName": "Ada Okafor",
      "name": null,
      "firstName": "Ada",
      "middleName": null,
      "lastName": "Okafor",
      "email": "ada@example.com",
      "phoneNumber": "+2348012345678",
      "dateOfBirth": "1992-04-18",
      "gender": "female",
      "address": {
        "line1": "14 Marina Road",
        "line2": null,
        "city": "Lagos",
        "state": "Lagos",
        "postalCode": "100001",
        "country": "NG"
      },
      "tier": 1,
      "hasBvn": true,
      "hasNin": false,
      "hasPassport": false,
      "hasDriversLicence": false,
      "hasTaxId": false,
      "hasRegistrationNumber": false,
      "createdAt": "2026-08-14T09:00:00.000Z",
      "updatedAt": "2026-08-14T09:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "total": 1,
    "pageCount": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}

{
  "statusCode": 400,
  "message": "Must be a valid identifier.",
  "code": "validation_failed",
  "errors": [
    {
      "message": "Must be a valid identifier.",
      "field": "accountId",
      "code": "custom",
      "path": [
        "accountId"
      ]
    }
  ]
}

{
  "statusCode": 401,
  "code": "INVALID_API_KEY",
  "message": "Invalid or inactive API credentials."
}

{
  "statusCode": 404,
  "code": "resource_not_found",
  "message": "Resource not found."
}

{
  "statusCode": 409,
  "code": "resource_conflict",
  "message": "The request conflicts with the current resource state."
}

{
  "statusCode": 429,
  "message": "Too many API requests. Try again later.",
  "code": "api_key_rate_limit_exceeded",
  "retryAfterSeconds": 17
}

{
  "statusCode": 500,
  "code": "internal_server_error",
  "message": "An unexpected error occurred."
}