Skip to main content
GET
List expense reports for organization

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required

The organization id

Query Parameters

statuses
enum<string>[]

Comma separated list of statuses to include, to exclude a status use ! before the status

Available options:
APPROVAL,
APPROVED,
BULK_TRANSFER,
DELETED,
ERROR,
NEW,
NORMAL,
ON_HOLD,
PAID,
READY_TO_SEND,
REJECTED,
REVIEW,
SEND,
SENT,
TRANSFER,
TRANSFER_TO_RECIPIENT
include
enum<string>[]

Parameter used to include additional data in the response. Available options:

  • expenseRecords: Include all expense records in the report
  • approvalChain: Include approval chain information (reminderSentToApprover, hasRejectedExpenseRecords, hasIncorrectApprovalChains, currentApproverInfo, approvalAllowed)
  • sendChain: Include send chain information (sendChain, hasIncorrectApprovalChains)
  • employeeId: Include the employee ID of the report owner
  • tag: Include tag information (simulatedCardReport, integrationTest, dimensions)
  • externalReports: Include reports an integration module is still working on, under meta.externalReports
  • meta.violations: Include the report's policy violations
  • meta.messages: Include the direct messages attached to the report
  • meta.autoApproval: Include the AI review guidance verdict for the report
  • meta.ids: Include the ids of every report matching the filter, ignoring pagination, under meta.ids
Available options:
expenseRecords,
approvalChain,
sendChain,
employeeId,
tag,
externalReports,
meta.violations,
meta.messages,
meta.autoApproval,
meta.ids
max
integer<int>
default:10

Max records to return

Required range: 1 <= x <= 1000
offset
integer<int>
default:0

Offset to be used in list

Required range: x >= 0
q
string

Parameter used in the search

sort
string
default:lastUpdated:desc

Sort parameter for expense reports. Accepts one or more sorting criteria in the format property:direction, where property is one of name, dateCreated, sent, reportNumber, ownerName, totalAmount, organizationName, organizationNumber, approved, lastUpdated, paid, status, employeeId, dueDate; and direction is either asc or desc. Multiple criteria can be provided as a comma-separated list. Default is lastUpdated:desc. Company card listings (companyCardOnly=true) always append owner last name ascending as a secondary sort, so the order within tied values is stable across pages.

filterStatus
enum<string>

Filter ON_HOLD reports by substatus

Available options:
card_not_configured,
reserved_transaction
fromDate
string<date>

Used for filtering

toDate
string<date>

Used for filtering

companyCardOnly
boolean
default:false

When true, only company card expense reports are returned. The response meta will also include aggregated totalAmount and totalExpenses for the whole filtered set.

recipientId
string

Filters the listing to reports whose next recipient is this one, meaning the step with the lowest sortOrder among the steps still in TRANSFER_TO_RECIPIENT. Used by the Ready to send tab, which is split per recipient. Only applied to organization listings.

UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$
reportGroup
integer

Zero based index of the report group to return, used by the Ready to send tab to split a large listing into slices. Reports are assigned to a group by their creation time, so the groups are stable and disjoint. Only applied when the owner is configured with more than one group (an organization's reportGroupSettings.numberOfRTSGroups, or a partner's numberOfReportGroups); otherwise the parameter is ignored and the full listing is returned.

Required range: x >= 0

Response

200 - application/json

OK

meta
object
data
object[]
Last modified on August 31, 2026