Skip to main content
GET
/
api
/
customers
curl -X GET 'https://crypto-api.yativo.com/api/customers?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "data": {
    "customers": [
      {
        "id": "cust_01HX9KZMB3F7VNQP8R2WDGT4E5",
        "email": "jane@example.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "status": "active",
        "kyc_status": "approved",
        "created_at": "2026-03-01T10:00:00Z",
        "updated_at": "2026-03-25T09:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 45,
      "total_pages": 3
    }
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
page
number
Page number for pagination. Default: 1
​
limit
number
Results per page. Default: 20, max: 100
​
status
string
Filter by customer status. Accepted values: active, suspended, pending
​
search
string
Search by email or name (partial match supported).
interface Customer {
  id: string;
  email: string;
  first_name: string;
  last_name: string;
  status: "active" | "suspended" | "pending";
  kyc_status: "not_started" | "pending" | "approved" | "rejected";
  created_at: string;
  updated_at: string;
}

interface ListCustomersResponse {
  status: "success";
  data: {
    customers: Customer[];
    pagination: {
      page: number;
      limit: number;
      total: number;
      total_pages: number;
    };
  };
}

curl -X GET 'https://crypto-api.yativo.com/api/customers?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "data": {
    "customers": [
      {
        "id": "cust_01HX9KZMB3F7VNQP8R2WDGT4E5",
        "email": "jane@example.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "status": "active",
        "kyc_status": "approved",
        "created_at": "2026-03-01T10:00:00Z",
        "updated_at": "2026-03-25T09:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 45,
      "total_pages": 3
    }
  }
}