> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenumero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List, Get, Update & Delete Customers

> Read a paginated list of customers, fetch one by id, update its details, or delete it.

Read and manage your customer records. All four calls are authenticated with your API key only — no signature required.

## List customers

```
GET /api/v1/business/customers
```

| Query param | Type    | Default | Description                                |
| ----------- | ------- | ------- | ------------------------------------------ |
| `page`      | integer | 1       | Page number                                |
| `pageSize`  | integer | 25      | Rows per page                              |
| `search`    | string  | —       | Filter by name, email, phone or externalId |

```bash theme={null}
curl "https://api.usenumero.com/numeroaccount/api/v1/business/customers?page=1&pageSize=25&search=john" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"
```

Rows are returned in `data.items`, with page info alongside:

```json theme={null}
{
  "data": [
    {
      "id": 4021,
      "externalId": "user_10231",
      "firstName": "John",
      "lastName": "Doe",
      "kycStatus": "PENDING"
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": {
      "page": 1,
      "page_size": 25,
      "total": 1,
      "has_more": false
    }
  }
}
```

## Get a customer

```
GET /api/v1/business/customers/{id}
```

```bash theme={null}
curl "https://api.usenumero.com/numeroaccount/api/v1/business/customers/4021" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"
```

Returns the full customer object (same shape as [Create](/api-reference/customers-create)).

## Update a customer

```
PATCH /api/v1/business/customers/{id}
```

Send only the fields you want to change (`email`, `phone`, `firstName`, `lastName`, `country`, `metadataJson`).

```bash theme={null}
curl -X PATCH "https://api.usenumero.com/numeroaccount/api/v1/business/customers/4021" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{ "phone": "08099998888", "metadataJson": "{\"tier\":\"platinum\"}" }'
```

Returns the updated customer object.

## Delete a customer

```
DELETE /api/v1/business/customers/{id}
```

```bash theme={null}
curl -X DELETE "https://api.usenumero.com/numeroaccount/api/v1/business/customers/4021" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"
```

```json theme={null}
{
  "data": true,
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```