---
title: "List and search expense claims"
method: GET
path: "/v1/expenses"
tags: ["expenses"]
---

# List and search expense claims

`GET /v1/expenses`

Retrieve a paginated list of expense claims with filtering and sorting capabilities.

This endpoint allows partners to:
- Search expenses by employee name
- Filter by expense status (draft, approved, paid, etc.)
- Use predefined views for common queries
- Sort by submission date, amount, or creation date
- Paginate through large result sets

Results include expense summary information and can be filtered to show only relevant expenses based on status, employee, or predefined views.

## Query parameters

- `page` integer
- `pageSize` integer
- `memberName` string
- `status` string[]
- `view` 'ALL_PENDING' | 'PENDING_ON_ME' | 'HISTORY'
- `sortBy` 'submittedAt' | 'totalAmount' | 'createdOn' | 'updatedOn'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

List of expenses retrieved successfully

- V1ExpensesGetResponse
  - `data` V1ExpensesGetResponseExpense[], required — List of expenses
    - `expenseId` string, uuid, required — Unique identifier for the expense
    - `title` string, required — Expense title
    - `status` 'DRAFT' | 'REVOKED' | 'APPROVAL_IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'PROCESSING' | 'PAID' | 'TO_BE_PAID' | 'ON_HOLD' | 'UNKNOWN', required — Current status of the expense
    - `totalAmount` number, float, required — Total expense amount
    - `currency` string, required — Currency code (ISO 4217)
    - `submittedAt` string, date-time — When the expense was submitted
    - `createdOn` string, date-time — When the expense was created
    - `employeeId` string, uuid — Employee unique identifier. Use GET /v1/employees/{employeeId} for full employee details
    - `items` V1ExpensesGetResponseItem[] — List of expense line items
      - `itemId` string, uuid — Unique identifier for the expense item
      - `title` string
      - `amount` number, float
      - `date` string, date-time
      - `category` V1ExpensesGetResponseCategory — Expense category information
        - `id` string, uuid — Category unique identifier
        - `name` string
      - `description` string
  - `pagination` Pagination, required — Pagination information for list responses
    - `page` integer, required — Current page number (1-based)
    - `pageSize` integer, required — Number of items per page
    - `totalCount` integer, required — Total number of items across all pages
    - `totalPages` integer, required — Total number of pages

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Forbidden - insufficient permissions
- `422` — Unprocessable entity - validation error
- `500` — Internal server error
- `503` — Service unavailable - upstream dependency error

---

[API](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api.md) · [All operations](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usemultiplier/multiplier-public-rest-api/revisions/59cd6443fdbf/schema)