---
title: "List customers"
method: GET
path: "/api/customers"
tags: ["Customers"]
---

# List customers

`GET /api/customers`

Retrieve a paginated list of customers. Supports filtering by search term, country, and currency.

## Query parameters

- `page` number
- `limit` number
- `search` string
- `country` string
- `currency` string
- `sortBy` string
- `sortOrder` 'asc' | 'desc'

## Response `200`

Paginated list of customers with metadata

- PaginatedCustomerResponse
  - `data` CustomerResponse[], required
    - `id` string, required
    - `externalId` string, required
    - `email` string, required
    - `name` string
    - `country` string
    - `currency` string, required
    - `metadata` object
    - `createdAt` string, required
    - `updatedAt` string, required
  - `meta` PaginationMeta, required
    - `total` number, required
    - `page` number, required
    - `limit` number, required
    - `totalPages` number, required

## Other responses

- `401` — Unauthorized - invalid or missing API key

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/versions/0e449a4e0dc8/schema)