---
title: "Get expenses for a company"
method: GET
path: "/expenses"
tags: ["Expenses"]
deprecated: true
---

# Get expenses for a company

`GET /expenses`

> **Deprecated.**

By default does not return expenses with Transaction State AUTHORIZATION or AUTHORIZATION_REVERSAL.

## Query parameters

- `pageOffset` number
- `pageSize` number
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `types` string[]
- `accountId` string
- `tagId` string
- `transactionStates` string[]
- `status` string[]

## Response `200`

Expenses have been returned

- ExpensesResponse
  - `expenses` object[], required — A list of expenses fetched for the requested page
    - `id` string, required — The unique UUID identifier of the expense
    - `employeeId` string — Unique UUID identifier of the employee that performed the expense
    - `employeeCode` string — External identifier of the employee that performed the expense
    - `departmentId` string — Unique UUID identifier of the department for which the employee executing the expense belongs to
    - `performedAt` string, date-time, required — The date the expense was performed in the format YYYY-MM-DDTHH:mi:ss.SSSZ
    - `amountOriginal` object, required — The amount and currency the transaction was originally in
      - `value` number, required
      - `currency` string, required — 3-Letter currency code
    - `amountSettled` object — The settlement amount and currency
      - `value` number, required
      - `currency` string, required — 3-Letter currency code
    - `note` string — Additional comments on the expense added to enhance the purpose of the expense
    - `type` 'CARD' | 'PERSONAL_TRANSFER' | 'BILL_INVOICE' | 'LOAD' | 'MANUAL' | 'MANUAL_TRANSFER' | 'PLEO_INVOICE' | 'EMPLOYEE_BANK_TRANSFER' | 'CASHBACK', required — The type of this expense.
    - `cardTransaction` object — This is the card transaction details of this expense specifically related CARD expense types.
      - `state` 'AUTHORIZATION' | 'AUTHORIZATION_REVERSAL' | 'CHARGE_BACK' | 'CHARGE_BACK_REVERSAL' | 'PRESENTMENT' | 'SECOND_PRESENTMENT' | 'REFUND' | 'LOAD' | 'UNLOAD' | 'FAILED', required — This is the transaction state of this card transaction.
      - `authorizedAt` string, date-time — Date and time the transaction was authorized in the format YYYY-MM-DDTHH:mi:ss.SSSZ.
      - `settledAt` string, date-time — Date and time the transaction was settled in the pleo wallet currency in the format YYYY-MM-DDTHH:mi:ss.SSSZ.
      - `reversedAt` string, date-time — Date and time the transaction was reversed if the transaction is in a reversal state in the format YYYY-MM-DDTHH:mi:ss.SSSZ.
      - `merchant` object, required — Merchant the transaction was executed at
        - `id` string — Merchant payment processor merchant identifier
        - `name` string, required — Name of the merchant
    - `accountId` string — This is the UUID pleo accounting category identifier for this expense, e.g. entertainment, travel etc.
    - `taxCodeId` string — This is the UUID tax code identifier for this expense
    - `tagIds` object[] — These are additional accounting-related information pertaining to the expense, these are usually extracted from the external accounting system.
      - `id` string — This is the UUID of the tag attached to the expense
      - `tagGroupId` string — UUID for the tag group to which expense tags are attached
    - `lines` object[], required — This is a breakdown of the expense lines for this expense, could also be potentially empty for non-card related expenses
      - `amountSettled` object, required — The breakdown settlement amount and currency for this expense line
        - `value` number, required
        - `currency` string, required — 3-Letter currency code
      - `accountId` string — This is the UUID pleo accounting category identifier for this expense line, e.g. entertainment, travel etc.
      - `taxCodeId` string — This is the UUID tax code identifier for this expense line
      - `tagIds` object[] — These are additional accounting-related information pertaining to the expense, these are usually extracted from the external accounting system.
        - `id` string — This is the UUID of the tag attached to the expense
        - `tagGroupId` string — UUID for the tag group to which expense tags are attached
    - `receiptIds` string[] — Unique identifiers (UUIDs) for the receipts attached to this expense
    - `settledExpenseIds` string[] — Unique identifiers (UUIDs) of the related settled Expenses in case the expense is a reimbursement of *TRANSFER family
    - `status` 'NOT_EXPORTED' | 'QUEUED' | 'EXPORTING' | 'EXPORTED', required — This is related to export status information
    - `supplier` object — Expense supplier information.
      - `CIF` string — CIF code of the expense
      - `documentNumber` string — Document number of the expense
    - `createdAt` string, date-time, required — Date and time this record was created in the pleo system in the format YYYY-MM-DDTHH:mi:ss.SSSZ
    - `updatedAt` string, date-time, required — Date and time this record was last updated in the pleo system in the format YYYY-MM-DDTHH:mi:ss.SSSZ
    - `deletedAt` string, date-time — Date and time this record was deleted in the pleo system in the format YYYY-MM-DDTHH:mi:ss.SSSZ
  - `metadata` object, required — Additional metadata including pagination information
    - `pageInfo` object — Pagination information.
      - `nextPageOffset` number — The row number that should be used in the next fetch for the next page offset
      - `pageSize` number, required — The number of items returned in this page
      - `totalCount` number, required — The total number of items mapped to the filter criteria supplied

## Other responses

- `401` — request unauthorized
- `403` — Request forbidden; user has insufficient rights to a resource.
- `404` — route not found
- `500` — Something went wrong. Please contact the administrator if problems persist.

---

[API](https://skmtc.net/pleo/apis/gjoll-api.md) · [All operations](https://skmtc.net/pleo/apis/gjoll-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pleo/gjoll-api/versions/c70cd21dc330/schema)