How to Access Customer Data Using the Zepio Developer API

Creating API Key

The Customers API allows you to read customer details from your Zepio store using a secure API key.

Create API Key

• Login to your Zepio Admin Dashboard.
• Go to: Settings > Developer API
• Create a new API key and select this ability: Read customers

Use this API key when making requests to the Customers API.

Base URL

https://yourwebsite.com/api/developer/v1

Replace yourwebsite.com with your store domain.

Authentication

Send your API key as a Bearer Token in the request header.

Authorization: Bearer YOUR_API_KEY
Accept: application/json

Endpoints

Get Customers

Returns a list of customers from your store.

GET /api/developer/v1/customers

Query Parameters

Example Request

curl -X GET "https://yourwebsite.com/api/developer/v1/customers?per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Search Customers

curl -X GET "https://yourwebsite.com/api/developer/v1/customers?search=rahul" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Example Response

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "Rahul Sharma",
      "email": "rahul@example.com",
      "phone": "9876543210",
      "created_at": "2026-06-08T10:30:00.000000Z",
      "email_verified_at": null,
      "is_ban": false,
      "is_cod_disabled": false,
      "orders_count": 8,
      "completed_orders_count": 5,
      "default_wallet_amount": 250,
      "rewards_wallet_amount": 40
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6MTEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "prev_cursor": null,
    "next_page_url": "https://yourwebsite.com/api/developer/v1/customers?cursor=eyJpZCI6MTEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "prev_page_url": null,
    "per_page": 10
  }
}

Pagination

This API uses cursor based pagination.

To load the next page, use the next_cursor value from the response and pass it in the next request.

curl -X GET "https://yourwebsite.com/api/developer/v1/customers?per_page=10&cursor=NEXT_CURSOR_VALUE" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Get Single Customer

Returns details of a single customer by customer ID.

GET /api/developer/v1/customers/{id}

Example Request

curl -X GET "https://yourwebsite.com/api/developer/v1/customers/12" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Example Response

{
  "success": true,
  "data": {
    "id": 12,
    "name": "Rahul Sharma",
    "email": "rahul@example.com",
    "phone": "9876543210",
    "created_at": "2026-06-08T10:30:00.000000Z",
    "email_verified_at": null,
    "is_ban": false,
    "is_cod_disabled": false,
    "orders_count": 8,
    "completed_orders_count": 5,
    "cancelled_orders_count": 1,
    "default_wallet_amount": 250,
    "rewards_wallet_amount": 40
  }
}

Response Fields

Notes

• Only customers are returned from this API.
• The API key must have Read customers ability.
• Maximum per_page value is 100.
• Use cursor pagination for loading more customers.
• Search works with customer name, email, and phone number.