List expense reports

get

https://stage-api.findity.com/api/v1/admin/partners/{partnerId}/reports

Lists expense reports for the specified partner.

Path Params

partnerId

string

required

^[0-9a-fA-F]{32}$

The id of the partner for which we retrieve expense reports

Query Params

statuses

array of strings

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

statuses

include

array of strings

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

include

max

integer

1 to 1000

Defaults to 10

max records to return

offset

integer

≥ 0

Defaults to 0

the offset to be used in list

string

Parameter used in the search

reportGroup

integer

≥ 0

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.

sort

array of strings

Defaults to lastUpdated:desc

Specifies the property and direction for sorting the results. Each sorting criterion must use the property:direction format (e.g., name:asc or date:desc). You can apply multiple sorts by providing a comma-separated list (?sort=name:desc,date:asc) or by repeating the parameter (?sort=name:desc&sort=date:asc).

sort

Response

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK