# One customer (https://webmetic.de/docs/api/referenz/partner/customers-account-id)

## GET /partner/customers/{account_id}

One customer of your partner account, including the API key that reads its data.

A customer of another partner answers 404 like an unknown account id.

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

### Parameter

| Name | Ort | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- | --- |
| `account_id` | path | string | ja | Account id of the customer, from create-customer or the customer list |

### Antworten

| Status | Beschreibung |
| --- | --- |
| 200 | The customer, with its API key |
| 403 | API_KEY_MISSING, API_KEY_INVALID, API_KEY_NOT_FOUND, or NOT_A_PARTNER: the key does not belong to a partner account |
| 404 | CUSTOMER_NOT_FOUND: no customer of your partner account has this account id |
| 422 | VALIDATION_ERROR: the request is invalid; `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 |
| --- | --- | --- | --- |
| `account_id` | string | ja | Account id of the customer |
| `account` | string \| null | ja | Account name; for a customer created here the website name without suffix, e.g. nordhafen-anlagenbau |
| `email` | string \| null | ja | Login email of the first user; null without a user |
| `status` | string \| null | ja | Lifecycle of the account, e.g. partner_trial or trial |
| `account_type` | string | ja | Who bills: partner_customer you, partner_direct Webmetic |
| `api_key` | string \| null | ja | The customer's own API key |
| `websites` | string[] | ja | Domains of the customer as stored |
| `usage` | UsagePeriod[] | ja | Identified companies per billing period; empty for a new customer |
| `usage[].period` | string \| null | nein | Billing period as YYYY-MM-DD_YYYY-MM-DD |
| `usage[].company_count` | integer \| null | nein | Companies identified in the period so far |
| `usage[].estimate` | integer \| null | nein | Expected companies over 30 days; only in the current period |
| `usage[].confidence` | string \| null | nein | Reliability of the estimate: excellent, high, medium, low, very_low or no_data; only in the current period |
| `whitelabel` | boolean | ja | true for a whitelabel customer |
| `created_at` | string \| null | ja | When the account was created, ISO 8601 without offset, e.g. 2026-10-22T09:14:03.512000 |

### Beispiel

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