---
title: 'List customers'
description: 'List the customers of a shop with the API.'
url: 'https://repender.nl/docs/api/customers/list-customers'
last_updated: '2026-11-10'
---

> Docs index: https://repender.nl/docs/llms.txt · MCP: https://repender.nl/docs/mcp · Skill: https://repender.nl/docs/skill.md

# List customers

This endpoint needs the Pro plan and works on the customers of the shop from the [shop context](https://repender.nl/docs/api.md#shop-context). See the [API overview](https://repender.nl/docs/api.md) for authentication, the rate limit and pagination.

`GET /customers`

Paginated, ordered by id.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `created_after` | date | No | Only return customers created after this date. Use this to sync new customers. |
| `page` | integer | No | Page number. Defaults to 1. |
| `per_page` | integer | No | Up to 100. Defaults to 25. |

```json
{
  "current_page": 1,
  "data": [
    {
      "id": 512,
      "name": "Jane Doe",
      "is_company": false,
      "company_name": null,
      "postal_code": "1234 AB",
      "house_number": 12,
      "house_number_addition": null,
      "street": "Main Street",
      "city": "Amsterdam",
      "country_id": 1,
      "phone_number": "+31612345678",
      "email": "jane@example.com",
      "invoice_email": null,
      "registration_number": null,
      "vat_number": null,
      "codice_fiscale": null,
      "remarks": null
    }
  ],
  "last_page": 21,
  "per_page": 25,
  "total": 512,
  "next_page_url": "https://repender.nl/api/v1/customers?page=2",
  "prev_page_url": null
}
```
