Skip to main content
GET
Get Statements
Use the /api/fdx/5/accounts/{accountId}/statements endpoint to get a paginated list of the statements available for a particular account. Use the statementId from the response to call Download Statement. To successfully call this endpoint, you must first call the /Token endpoint to obtain a valid access_token using:
  • grant_type: authorization_code or refresh_token
  • client_id: {recipient client_id}
  • client_secret: {recipient client_secret}
  • redirect_uri: {recipient redirect_uri}
  • code: {with grant type authorization_code}
  • refresh_token: {with grant type refresh_token}

Filter and paginate results

Use startTime and endTime (YYYY-MM-DD) to limit the statements to a date range. If you provide one, you must provide both, and startTime must not be after endTime. Otherwise you’ll receive error 702 or 703. A date that isn’t in YYYY-MM-DD format returns error 401 (Invalid Input). If you omit both dates, the Data Provider applies a default date range, which varies by provider. Use limit to set the page size. When more results are available, the response includes page.nextOffset and links.next.href. Pass the nextOffset value as the offset parameter to get the next page.

Partial success

If the Data Provider can only return part of the data, the endpoint responds with HTTP 206 Partial Content and the same response body.

Statement status

Each statement has a status that tells you whether it can be downloaded. The status is set by the Data Provider, so the statements a provider returns, and when they become AVAILABLE, can vary.

Not all Data Providers support this endpoint

If the Data Provider does not support statements, this endpoint returns error 501 (Subsystem unavailable) with a 405 status code.

How to handle an error response

If you receive an error response, refer to the List of Data Access Errors for more information about the error and how to resolve it.

Authorizations

Authorization
string
header
required

Bearer token obtained from the /Token endpoint.

Path Parameters

account_id
string
required

The ID of the customer account that you want to retrieve statements for.

Query Parameters

startTime
string<date>

The first date in the date range that you want to retrieve statements for, in ISO format (YYYY-MM-DD).

endTime
string<date>

The last date in the date range that you want to retrieve statements for, in ISO format (YYYY-MM-DD).

offset
string

Opaque cursor used by the provider to send the next set of records.

limit
integer

The maximum number of statements that you want to return with this request. Use this field to set a limit on the amount of data you receive.

Response

Returned when the statements are successfully retrieved with pagination.

page
object

Pagination information for the response.

Links for pagination.

statements
object[]

List of statements for the account.