# Get Customer list by tenant

`GET /public/api/v1.1/Tenants/{tenantId}/Customers`

User API · Customers · base URL `https://user-api.ancon.io` · auth: `Access-Token` header · docs: https://ancon.dev/api/user/customers/get-customer-list-by-tenant-v1.1

### Available filter properties
- name (string)
- firstname (string)
- lastname (string)
- created (datetime)
- email (string)
- firstorder (datetime)
- lastorder (datetime)
- totalonlineorders (int)
- totalposorders (int)
- totalspent (decimal)
- outletid (guid)
- tenantid (guid)
- ordersonoutlets (guid)
- salesourceid (nullable guid)

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `tenantId` | string (uuid) | yes |  |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Offset` | integer (int32) | no |  |
| `Limit` | integer (int32) | no | min 0, max 1000. |
| `Order` | string | no |  |
| `Search` | string | no |  |
| `Filter` | map<string, array<string>> | no |  |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `correlationId` | string | no | Correlation Id for the request |

## Responses

| Status | Description |
| --- | --- |
| 200 | OK |
| 401 | Unauthorized |
| 404 | Not Found |

### 200 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array<object> or null | no |  |
| `items[].id` | string (uuid) | no |  |
| `items[].created` | string (date-time) | no |  |
| `items[].firstName` | string or null | no |  |
| `items[].lastName` | string or null | no |  |
| `items[].email` | string or null | no |  |
| `items[].languageCode` | string or null | no |  |
| `items[].isDeleted` | boolean | no |  |
| `items[].isDisabled` | boolean | no |  |
| `items[].totalOnlineOrders` | integer (int32) | no |  |
| `items[].totalPosOrders` | integer (int32) | no |  |
| `items[].totalSpent` | object or null | no |  |
| `items[].totalSpent.amount` | number (double) | no |  |
| `items[].totalSpent.currency` | string or null | no |  |
| `items[].firstOrder` | string (date-time) or null | no |  |
| `items[].lastOrder` | string (date-time) or null | no |  |
| `items[].saleSourceId` | string (uuid) or null | no |  |
| `meta` | object or null | no |  |
| `meta.count` | integer (int32) | no |  |
| `meta.offset` | integer (int32) | no |  |

#### Example

```json
{
  "items": [
    {
      "id": "000b4bb8-3cf8-4213-915b-b34b823fd087",
      "created": "2026-10-20T14:33:35.477122Z",
      "firstName": "Adrian",
      "lastName": "Svensson",
      "email": "adrian@svensson.io",
      "languageCode": "sv-SE",
      "isDeleted": false,
      "isDisabled": false,
      "totalOnlineOrders": 1,
      "totalPosOrders": 0,
      "totalSpent": {
        "amount": 123,
        "currency": "SEK"
      },
      "firstOrder": "2026-10-21T14:33:35.4771271Z",
      "lastOrder": "2026-10-22T14:33:35.4771276Z",
      "saleSourceId": null
    },
    {
      "id": "a8d501a3-2035-4387-afc0-438d24d08808",
      "created": "2026-10-11T14:33:35.4771331Z",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john@smith.io",
      "languageCode": "en-US",
      "isDeleted": false,
      "isDisabled": false,
      "totalOnlineOrders": 0,
      "totalPosOrders": 3,
      "totalSpent": {
        "amount": 1223,
        "currency": "SEK"
      },
      "firstOrder": "2026-10-20T14:33:35.4771336Z",
      "lastOrder": "2026-10-21T14:33:35.4771337Z",
      "saleSourceId": null
    },
    {
      "id": "665bf9a6-b4ff-44b2-a478-981a32dca520",
      "created": "2026-10-18T14:33:35.4771522Z",
      "firstName": null,
      "lastName": null,
      "email": null,
      "languageCode": "en-US",
      "isDeleted": true,
      "isDisabled": false,
      "totalOnlineOrders": 3,
      "totalPosOrders": 5,
      "totalSpent": {
        "amount": 805,
        "currency": "SEK"
      },
      "firstOrder": null,
      "lastOrder": null,
      "saleSourceId": null
    },
    {
      "id": "15b50854-48fa-4fb6-aa14-428b9b5a9486",
      "created": "2026-04-26T14:33:35.4771547Z",
      "firstName": null,
      "lastName": null,
      "email": null,
      "languageCode": "nb-NO",
      "isDeleted": false,
      "isDisabled": true,
      "totalOnlineOrders": 0,
      "totalPosOrders": 123,
      "totalSpent": {
        "amount": 121233,
        "currency": "NOK"
      },
      "firstOrder": "2026-10-15T14:33:35.4771561Z",
      "lastOrder": "2026-10-16T14:33:35.4771561Z",
      "saleSourceId": null
    }
  ],
  "meta": null
}
```

### 404 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |
| `errorCode` | string (uuid) | no |  |

#### Example (from schema)

```json
{
  "message": "string",
  "errorCode": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```

## Example request

```bash
curl -X GET "https://user-api.ancon.io/public/api/v1.1/Tenants/{tenantId}/Customers" \
  -H "Access-Token: $ANCON_TOKEN"
```