---
title: "List expenses"
method: GET
path: "/v1/expenses"
tags: ["Expenses"]
---

# List expenses

`GET /v1/expenses`

List expenses under the same account. Admin and bookkeeper have access to any expense, and regular users can only access their own.

## Query parameters

- `expand[]` string[], nullable
- `user_id[]` string[], nullable
- `parent_expense_id[]` string[], nullable
- `budget_id[]` string[], nullable
- `spending_entity_id[]` string[], nullable
- `expense_type[]` ExpenseType[], nullable
- `status[]` ExpenseStatus[], nullable
- `payment_status[]` ExpensePaymentStatus[], nullable
- `compliance_status[]` ExpenseComplianceStatus[], nullable
- `derived_compliance_status[]` ExpenseDerivedComplianceStatus[], nullable
- `purchased_at_start` string, date-time, nullable
- `purchased_at_end` string, date-time, nullable
- `updated_at_start` string, date-time, nullable
- `updated_at_end` string, date-time, nullable
- `payment_posted_at_start` string, date-time, nullable
- `payment_posted_at_end` string, date-time, nullable
- `load_custom_fields` boolean, nullable
- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

List expenses response.

- PageExpandableExpense
  - `next_cursor` string, nullable
  - `items` ExpandableExpense[], required — unresolved $ref

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/brex-com/apis/expenses-api.md) · [All operations](https://skmtc.net/brex-com/apis/expenses-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/expenses-api/revisions/83302fc5e4a8/schema)
