---
title: "List your customers"
method: GET
path: "/api/v1/customers"
tags: ["Reseller API: act as your customers"]
---

# List your customers

`GET /api/v1/customers`

## Request

- Base URL: `https://hproxy.com`
- URL: `https://hproxy.com/api/v1/customers`
- Auth: API key in header `X-API-Key`

Every customer on your account, newest first, with identity and credit, the read your backend reconciles against. This is an **account-level** call: send it **without** the `X-Reseller-Customer-Id` header (naming a customer here is refused with a `400` telling you to drop the header).

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input. The body names the field and the accepted set.
- `401`: Missing or invalid API key.
- `429`: Rate limited. Retry after the delay in the response.

---

[API](https://skmtc.dev/hproxy/apis/hproxy-api.md) · [All operations](https://skmtc.dev/hproxy/apis/hproxy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hproxy/apis/hproxy-api/revisions/9f6898fe76e2?raw)