Sign in

v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2684278289.5 KB
Accounts

Get account statements

Retrieve a paginated list of monthly statements for a specific account. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters, as well as date range filtering with start and end parameters.

get/account/{accountId}/statements

Path parameters

accountIdstring uuid required

ID for a Mercury account.

Query parameters

limitinteger

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

order'asc' | 'desc'

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

start_afterstring uuid

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

end_beforestring uuid

The ID of the statement 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.

startstring

Filter statements where the period start date is on or after this date. Format: YYYY-MM-DD

endstring

Filter statements where the period start date is on or before this date. If the date is in the future, defaults to the current date. Format: YYYY-MM-DD

Response

Example response

{
  "statements": [
    {
      "endDate": "2016-07-22T00:00:00Z",
      "startDate": "2016-07-22T00:00:00Z",
      "transactions": [
        {
          "createdAt": "2016-07-22T00:00:00Z",
          "postedAt": "2016-07-22T00:00:00Z"
        }
      ]
    }
  ]
}