Skip to main content
GET
/
v1
/
customers
List merchant customers
curl --request GET \
  --url https://staging.api.payluk.ng/v1/customers \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "message": "Customers fetched successfully",
  "data": {
    "pagination": {
      "count": 1,
      "pages": 1,
      "isLastPage": true,
      "nextPage": null,
      "previousPage": null
    },
    "data": [
      {
        "id": "665f1b2c9a1e4d0012ab3c01",
        "firstname": "Ada",
        "email": "[email protected]"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (test) or sk_live_... (live).

Query Parameters

page
integer
default:1

Page number (1-based).

limit
integer
default:10

Items per page.

Response

200 - application/json

Paginated customers.