GET
https://api.posnova.store/v1/customersList Customers
Retrieve your store's customer records, newest first. This is your own first-party data — it is only visible to your API keys.
Query Parameters
| Parameter | Description |
|---|---|
limit integer • optional | Number of customers to return. Default 50, maximum 100. |
page integer • optional | Page number for pagination. Default 1. |
status string • optional | Filter by account status, e.g. Active. |
search string • optional | Case-insensitive search on name or email. |
Request Example
cURL
curl "https://api.posnova.store/v1/customers?search=rahim" \ -H "Authorization: Bearer pn_live_YourSecretKey"
JavaScript
const res = await fetch("https://api.posnova.store/v1/customers?search=rahim", {
headers: { Authorization: `Bearer ${process.env.POSNOVA_API_KEY}` },
});
const { data, pagination } = await res.json();JSON Response
{
"success": true,
"data": [
{
"id": "7f3b9a10-…",
"name": "Rahim Uddin",
"email": "rahim@example.com",
"phone": "01700000000",
"status": "Active",
"email_verified": true,
"loyalty_points": 120,
"total_spent": 45900,
"tags": ["vip"],
"city": "Dhaka",
"created_at": "2026-05-01T10:00:00Z",
"last_login": "2026-07-01T08:30:00Z"
}
],
"pagination": { "total": 412, "page": 1, "limit": 50 }
}GET
https://api.posnova.store/v1/customers/{id}Retrieve Customer
Fetch a single customer by UUID. Returns 404 when the customer does not exist in your store.
PII boundaries
Password hashes, verification tokens, and encrypted PII columns are never exposed through the API — only operational fields are returned. Handle customer data according to your local privacy regulations.
Status: Operational