---
title: "List expense items"
method: GET
path: "/expense-items"
tags: ["Expense Items"]
---

# List expense items

`GET /expense-items`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/expense-items`
- Auth: HTTP bearer

## Query parameters

- `startingAfter` string
- `endingBefore` string
- `limit` integer
- `modifiedAtAfter` union
  - string, date
  - string, date-time
- `modifiedAtOnAfter` union
  - string, date
  - string, date-time
- `modifiedAtBefore` union
  - string, date
  - string, date-time
- `modifiedAtOnBefore` union
  - string, date
  - string, date-time
- `expenseReportId` string
- `isReimbursed` 'true' | 'false'

## Response `200`

200

- object
  - `results` ExpenseItem[]: The list of results for the current page.
    - `id` string: The unique identifier for the object.
    - `statusId` 'not_submitted' | 'pending_approval' | 'approved' | 'rejected': The approval status of the expense item.
    - `vendor` string, nullable: The name of the vendor for the expense.
    - `notes` string, nullable: Additional notes about the expense item.
    - `attendees` string, nullable: The attendees for the expense (e.g. for meals or entertainment categories).
    - `date` string, date: The date of the expense. In the form `YYYY-MM-DD`.
    - `currency` string: The ISO 4217 currency code for the expense amount (e.g. `USD`).
    - `amount` number: The expense amount in the expense's currency.
    - `markupMethod` 'percentage' | 'amount' | 'null', nullable: The markup method applied to the expense. `null` if no markup is applied.
    - `markupRatio` number, nullable: The markup ratio (e.g. 0.1 for 10%). Present when `markupMethod` is `percentage`, otherwise `null`.
    - `markupAmount` number, nullable: The fixed markup amount. Present when `markupMethod` is `amount`, otherwise `null`.
    - `markup` number, nullable: The computed markup value in the expense's currency. `null` when no markup method is set.
    - `total` number: The total billed amount including any markup, in the expense's currency.
    - `unitCount` number, nullable: The number of units for unit-based expense categories. `null` if not applicable.
    - `unitAmount` number, nullable: The per-unit amount for unit-based expense categories. `null` if not applicable.
    - `isReimbursable` boolean: Whether the expense is reimbursable to the member.
    - `isBillable` boolean: Whether the expense item is billable back to the client.
    - `isReimbursed` boolean: Whether the expense has been reimbursed to the member.
    - `createdAt` string, date-time: The timestamp when the object was created.
    - `modifiedAt` string, date-time: The timestamp when the object was last modified.
    - `expenseReport` object: The expense report this item belongs to.
      - `id` string: The unique identifier for the object.
      - `title` string: The title of the expense report.
    - `expenseCategory` object: The expense category for this item.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the expense category.
      - `unitName` string, nullable: The unit name for unit-based categories (e.g. "mile"). `null` if not a unit-based category.
    - `member` object: The member who submitted the expense.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the member.
    - `project` object, nullable: The project associated with this expense item. `null` if not assigned to a project.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the project.
      - `client` object: The client associated with the project.
        - `id` string: The unique identifier for the object.
        - `name` string: The name of the client.
    - `receipts` ExpenseReceipt[]: The receipts attached to this expense item, oldest first. Receipts whose file upload never completed are not included.
      - `id` string: The unique identifier for the object.
      - `fileName` string: The name of the receipt file.
      - `contentType` string: The content type reported when the receipt was uploaded. The download endpoint sends the file with a content type derived from `fileName` instead.
      - `createdAt` string, date-time: The timestamp when the object was created.
    - `invoiced` boolean: Whether this record has been invoiced.
  - `hasMore` boolean: Whether there are more results available after this page.

## Other responses

- `400`: 400
- `403`: 403

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)