# Customers (https://webmetic.de/docs/api/referenz/partner/customers)

## GET /partner/customers

Every customer of your partner account, newest first, paged with `limit` and `offset`.

`count` is the number of customers on this page, `total` the number over all pages.

Note: This endpoint is rate-limited to 60 requests per minute.

### Parameter

| Name | Ort | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | nein | Customers per page, from 1 up to a maximum of 500 |
| `offset` | query | integer | nein | Customers to skip, from 0; add `limit` to page on |

### Antworten

| Status | Beschreibung |
| --- | --- |
| 200 | One page of customers, newest first |
| 403 | API_KEY_MISSING, API_KEY_INVALID, API_KEY_NOT_FOUND, or NOT_A_PARTNER: the key does not belong to a partner account |
| 422 | VALIDATION_ERROR: `limit` or `offset` is out of range (limit 1 to 500, offset from 0); `errors` lists each problem |
| 429 | RATE_LIMITED: more than 60 requests per minute to this endpoint |
| 500 | INTERNAL_ERROR: unexpected server error |

Felder der Antwort 200:

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `customers` | Customer[] | ja | Customers of your partner account, newest first |
| `customers[].account_id` | string | ja | Account id of the customer |
| `customers[].account` | string \| null | ja | Account name; for a customer created here the website name without suffix, e.g. nordhafen-anlagenbau |
| `customers[].email` | string \| null | ja | Login email of the first user; null without a user |
| `customers[].status` | string \| null | ja | Lifecycle of the account, e.g. partner_trial or trial |
| `customers[].account_type` | string | ja | Who bills: partner_customer you, partner_direct Webmetic |
| `customers[].api_key` | string \| null | ja | The customer's own API key |
| `customers[].websites` | string[] | ja | Domains of the customer as stored |
| `customers[].usage` | UsagePeriod[] | ja | Identified companies per billing period; empty for a new customer |
| `customers[].whitelabel` | boolean | ja | true for a whitelabel customer |
| `customers[].created_at` | string \| null | ja | When the account was created, ISO 8601 without offset, e.g. 2026-10-22T09:14:03.512000 |
| `count` | integer | ja | Customers on this page |
| `total` | integer | ja | Customers over all pages |
| `limit` | integer | ja | limit as requested |
| `offset` | integer | ja | offset as requested |
| `partner_account_id` | string | ja | Account id of your partner account |

### Beispiel

```bash
curl -X GET 'https://hub.webmetic.de/partner/customers' \
  -H 'Authorization: wmtc_IHR_API_SCHLUESSEL'
```