List customers (paginated)

GET

https://api-dev.skiplino.com/external/v1/customers/getAll

Returns the company's customers, newest-insertion order, with pagination metadata.

Authentication — Secret key only (sk_…).

Pagination — page (≥ 1, default 1) and limit (1–100, default 10). The
pagination object reports total, totalPages, and hasNextPage/hasPrevPage for
easy cursor-less paging.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200

application/json

Customers fetched successfully.

Bodyapplication/json

🟠422

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.skiplino.com/external/v1/customers/getAll?page=1&limit=10' \
--header 'X-Locale;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Customers fetched successfully.",
    "data": [
        {
            "_id": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b",
            "externalId": "crm-7741",
            "companyId": "cmp_5f3a91",
            "name": "Layla Hassan",
            "email": "layla.hassan@example.com",
            "mobile": "+97333445566",
            "metadata": {
                "tier": "gold"
            },
            "createdAt": "2026-06-23T11:00:00.000Z",
            "updatedAt": "2026-06-23T11:00:00.000Z"
        }
    ],
    "pagination": {
        "total": 137,
        "page": 1,
        "limit": 10,
        "totalPages": 14,
        "hasNextPage": true,
        "hasPrevPage": false
    }
}

Create a customer

Fetch one customer