List 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

Store API