# Get invoice list

`GET /api/v1/Outlets/{outletId}/Invoices`

Core API · Invoices · base URL `https://core-api.ancon.io` · auth: `Access-Token` header · docs: https://ancon.dev/api/core/invoices/get-invoice-list

### Available filter properties
- created (datetime)
- companyname (string)
- totalamount (decimal)
- totalcurrency (string)
- referencenumber (integer)

## Path parameters

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

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `OutletId` | string (uuid) | no |  |
| `Handled` | boolean | no | True or false.  For true invoices that are handled are returned.  For false invoices that are unhandled are returned. |
| `Offset` | integer (int32) | no | Offset the result, defaults to 0 |
| `Limit` | integer (int32) | no | Limits how many items to get, defaults to 100 min 0, max 1000. |
| `Order` | string | no | Order the result. |
| `Search` | string | no |  |
| `Filter` | map<string, array<string>> | no | Filter the result. Filter[created]=gte:2022-01-02 12:00:00&Filter[created]=lte:2022-08-03 22:00:00 |

## 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 | Invoice id is the same as order id. |
| `items[].referenceNumber` | integer (int64) | no | Reference number for the invoice / order. |
| `items[].createdAt` | string (date-time) | no |  |
| `items[].companyId` | string (uuid) | no |  |
| `items[].companyName` | string or null | no |  |
| `items[].total` | object or null | no | Total amount of the invoice. |
| `items[].total.amount` | number (double) | no |  |
| `items[].total.currency` | string or null | no |  |
| `items[].handlingStatus` | integer (int32) | no | Bitwise status of the invoice. 5 for example means that the invoice and refund is both unhandled. 10 means that both are handled. Allowed values: `1`, `2`, `4`, `8`. |
| `items[].integrationStatus` | string or null | no | A text representation of the handling status, will be one of the following values: "Invoice Unhandled" "Refund Unhandled" "Invoice and Refund UnHandled" or null. |
| `meta` | object or null | no |  |
| `meta.count` | integer (int32) | no |  |
| `meta.offset` | integer (int32) | no |  |

#### Example

```json
{
  "items": [
    {
      "id": "1c8d937f-0437-4e42-a190-c6eaa4166173",
      "referenceNumber": 341,
      "createdAt": "2026-10-23T14:33:34.1150507Z",
      "companyId": "d84ea955-277f-45ff-90ec-0288d306591d",
      "companyName": "Nice food AB",
      "total": {
        "amount": 120,
        "currency": "SEK"
      },
      "handlingStatus": 0,
      "integrationStatus": null
    },
    {
      "id": "1d3d3c02-d418-49b8-b7aa-18e2e4a66393",
      "referenceNumber": 341,
      "createdAt": "2026-10-23T14:33:34.1150557Z",
      "companyId": "5ebd6635-a660-457b-8275-fbef33ce7d36",
      "companyName": "Okay food AB",
      "total": {
        "amount": 180,
        "currency": "SEK"
      },
      "handlingStatus": 0,
      "integrationStatus": "Handled"
    }
  ],
  "meta": {
    "count": 2,
    "offset": 0
  }
}
```

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |

#### Example (from schema)

```json
{
  "message": "string"
}
```

### 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://core-api.ancon.io/api/v1/Outlets/{outletId}/Invoices" \
  -H "Access-Token: $ANCON_TOKEN"
```