List a budget's expenditures

get

https://api.mercury.com/api/v1/spend/budgets/{budgetId}/expenditures

List the non-deleted expenditures assigned to a budget, ordered by expenditure creation time, ascending (oldest first) by default. Supports cursor-based pagination with limit, order, start_at, start_after, and end_before query parameters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

budgetId

uuid

required

ID for the budget

Query Params

limit

int64

1 to 1000

Defaults to 1000

Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000

start_at

uuid

The ID of the budget expenditure to start the page at (inclusive). Cannot be combined with start_after or end_before.

start_after

uuid

The ID of the budget expenditure to start the page after (exclusive). When provided, results will begin with the budget expenditure immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.

end_before

uuid

The ID of the budget expenditure to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.

order

string

enum

Defaults to asc

Sort order. Can be 'asc' or 'desc'. Defaults to 'asc'

Allowed:

Responses

400

Invalid order or end_before or start_after or start_at or limit

404

budgetId not found

200