---
title: "List ExpenseClaims"
method: GET
path: "/api/v3/expenseClaims"
tags: ["ExpenseClaims"]
---

# List ExpenseClaims

`GET /api/v3/expenseClaims`

Retrieve a list of `ExpenseClaims`.

The `declaredOn` query parameter can operate comparisons with a given date-time value:
- `?declaredOn=2021-01-01`: strict equality.
- `?declaredOn=since,2021-01-01`: greater than or equal.
- `?declaredOn=until,2021-01-01`: lower than or equal.
- `?declaredOn=between,2021-01-01,2021-01-31`: comprised between two dates.

## Query parameters

- `ownerId` integer[]
- `orderBy` string
- `declaredOn` string
- `paging` string, required
- `statusId` string

## Response `200`

OK

- object
  - `data` object
    - `items` ExpenseClaim[]
      - `id` integer
      - `name` string — Name of the expense claim. If empty, it will be generated with the month and year of the last of claim item.
      - `declaredOn` string, date-time, required — Day the expenseClaim has been declared (Time zone Europe/Paris).
      - `createdOn` string, date-time, required — Day the expenseClaim has been created (Time zone Europe/Paris).
      - `modifiedOn` string, date-time, required — Day the expenseClaim has been modified (Time zone Europe/Paris).
      - `paymentReceivedOn` string, date-time — Day the expenseClaim has been paid (Time zone Europe/Paris).
      - `sourceId` object — The source describes how the expense was created: - 0: Legacy - 1: OldImport - 2: ImportByCb - 3: ImportByNature - 4: Anytime - 5: BudgetInsight - 6: Api - 7: Ocr - 8: Reconciliation - 9: InvoiceAggregator - 10: EmailAttachments - 11: FtpStatementImport - 12: CleemyPayment
        - `id` string
      - `source` object
        - `id` number
        - `name` string
        - `code` string
      - `paymentMethodId` 0 | 1 | 3 — How this expense was made: the owner used his money, an enterprise debit card, or a Cleemy card: - 0: User - 1: CorporateCard - 3: Cleemy Card
      - `paymentMethod` object
        - `id` number
        - `name` string
        - `code` string
      - `statusId` object — Status of the expenseClaim. - 1: the expenseClaim is created. - 2: the expenseClaim has been partially approved. - 3: the expenseClaim has been approved. - 4: the expenseClaim has been controlled. - 5: the expenseClaim has been approved and controlled. - 6: the payment of the expenseClaim has been initiated. - 7: the expenseClaim has been paid. - 8: the expenseClaim has been refused. - 9: the expenseClaim has been cancelled.
        - `id` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8
      - `status` object
        - `id` number
        - `name` string
        - `code` string
      - `approvalStateId` object — State of the approval of the expenseClaim. - 0: the approval is created. - 1: the expenseClaim has been partially approved. - 2: the expenseClaim has been approved. - 3: the expenseClaim has been refused. - 4: the expenseClaim has been cancelled.
        - `id` 0 | 1 | 2 | 3 | 4
      - `approvalState` object
        - `id` number
        - `name` string
        - `code` string
      - `authorizedActions` object — Authorized actions on the expenseClaim for the current user.
        - `isCancellable` boolean — The expenseClaim can be deleted by the current authenticated user.
        - `isEditable` boolean — The expenseClaim can be edited by the current authenticated user.
        - `isApprovable` boolean — The expenseClaim can be approved by the current authenticated user.
        - `isControllable` boolean — The expenseClaim can be controlled by the current authenticated user.
        - `isUnControllable` boolean — The current authenticated user can cancel the control of the expenseClaim.
      - `ownerId` integer — Unique identifier of the user that made this expenseClaim.
      - `owner` Owner
        - `id` integer
        - `name` string
        - `url` string, uri
        - `firstName` string
        - `lastName` string
      - `authorId` integer — Unique identifier of the user that created this grouping of expense.
      - `author` EntityBase
        - `id` integer
        - `name` string
        - `url` string
      - `legalEntityId` integer
      - `legalEntity` EntityBase
        - `id` integer
        - `name` string
        - `url` string
      - `departmentId` integer
      - `department` EntityBase
        - `id` integer
        - `name` string
        - `url` string
      - `currencyId` 'EUR' | 'USD' | 'CAD' | '...'
      - `currency` Currency
        - `id` 'EUR' | 'USD' | 'CAD' | '...'
        - `name` string — Label of the currency (eg: Pound sterling).
        - `url` string, uri

## Other responses

- `400` — Problem
- `401` — Problem
- `500` — Problem

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)