Statements

Create a statement request

Create a new statement request. The statement will be generated asynchronously and made available via the delivery channel specified by send_via. Supports accounts, trades, and incoming_funds statement types.

Valid statement_type / format combinations:

  • accounts: csv, pdf, xls, coda
  • trades: pdf, xls
  • incoming_funds: csv, pdf, xls

The currencies field is only valid when statement_type is accounts.

The range between date_from and date_to must not exceed 3 years.

post/statements

Request

  • Base URL: https://api.ebury.io
  • URL: https://api.ebury.io/statements
  • Auth: API key in header x-api-key

Query parameters

client_idstring required

The identifier of a client.

Headers

Authorizationstring required

The access token.

X-Contact-IDstring

The identifier of a contact.

Request body

statement_type'accounts' | 'trades' | 'incoming_funds' required

The type of statement to create.

date_fromstring date required

Start date for the statement (YYYY-MM-DD)

date_tostring date required

End date for the statement (YYYY-MM-DD)

format'csv' | 'pdf' | 'xls' | 'coda' required

The file format of the statement. Allowed values depend on statement_type — see the endpoint description for valid combinations.

currenciesstring

Comma-separated list of currency codes (ISO 4217). Only valid when statement_type is accounts.

send_via'push' | 'email' | 'both'

How the generated statement should be delivered

Example request

{
  "date_from": "2020-01-01",
  "date_to": "2020-01-31",
  "currencies": "EUR,GBP,USD"
}

Response

Statement request accepted

uuidstring required

Unique identifier for the statement request

statement_type'accounts' | 'trades' | 'mt940' | 'incoming_funds' required

Type of statement

file_format'pdf' | 'csv' | 'xls' | 'mt940' | 'coda' required

Format of the statement file

statusinteger required

Status code (0=Pending, 1=Running, 2=Completed, 3=Failed)

status_displaystring required

Human-readable status

start_datetimestring date-time required

Start date/time for the statement period

end_datetimestring date-time required

End date/time for the statement period

created_atstring date-time required

When the request was created

completed_atstring date-time nullable

When the statement was completed (null if not yet complete)

file_namestring nullable

Name of the generated file (null if not yet complete)

download_urlstring nullable

Pre-signed S3 URL for downloading the statement (null if not yet complete, expires after 15 minutes)

send_via'push' | 'email' | 'both' nullable

How the generated statement is delivered

error_messagestring nullable

Error message if the request failed

Example response

{
  "uuid": "86f62d50-baa2-38dd-f61c-0eacc34ead50",
  "statement_type": "accounts",
  "file_format": "pdf",
  "status": 2,
  "status_display": "Completed",
  "start_datetime": "2026-01-01T00:00:00",
  "end_datetime": "2026-03-31T23:59:59.999999",
  "created_at": "2026-04-07T21:18:49.061735",
  "completed_at": "2026-04-07T21:19:00.123456",
  "file_name": "statement_2026-01-01_2026-03-31.pdf",
  "download_url": "https://s3.amazonaws.com/bucket/file.pdf?X-Amz-Signature=abc123",
  "send_via": "push"
}

Changes

No recorded changes to this operation across all 1 revision of this API.