Fetch Customers

GET/api/v1/customers

Retrieves a list of customers.

Query Parameters

NameTypeRequiredDescription
limitintegerNoNumber of results (default: 20, max: 100).
cursorstringNoTimestamp for pagination (from previous response's endCursor).
third_party_identifierstringNoFilter by your internal ID.
customer_idstringNoFilter by customer ID.
1
Request Example
(cURL)
curl -X GET "https://api.piggyvest.business/api/v1/customers?limit=20" \\
-H "Authorization: Bearer YOUR_SECRET_KEY"

Success Response (200): (Paginated list of customers; similar to wallet fetch response structure.)