Get Statements
Use the /api/fdx/5/accounts//statements endpoint to retrieve a paginated list of available statements for a particular account.
/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_codeorrefresh_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
UsestartTime 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 astatus 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
Bearer token obtained from the /Token endpoint.
Path Parameters
The ID of the customer account that you want to retrieve statements for.
Query Parameters
The first date in the date range that you want to retrieve statements for, in ISO format (YYYY-MM-DD).
The last date in the date range that you want to retrieve statements for, in ISO format (YYYY-MM-DD).
Opaque cursor used by the provider to send the next set of records.
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.