Use **Report runs** operations to generate CSV reports of your Merchant account transactions. Choose from the following report types based on your use case:| Report type | Description || ----------- | ----------- || `custom_report` | Settled and processing transactions with a configurable set of columns. || `settlement_report` | All settled transactions, with a configurable set of columns. || `payments_report` | All payments, including failed and declined ones. || `payout_statement_report` | All transactions that contributed to a specific payout. || `icpp_fee_breakdown_report` | IC++ fee components broken down per transaction for a specific IC++ charge. |:::infoFor more information about how to generate CSV reports, see: [Create CSV reports of transactions](https://developer.revolut.com/docs/guides/merchant/monitor-and-observe/reports-reconciliation).:::
Revolut Report runs API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Report runs. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
3 operations
across 3 paths,
and defines 33 schemas.
It is described by OpenAPI 3.2.0, at version 2026-04-20.
Requests are made against 2 base URLs: https://merchant.revolut.com, https://sandbox-merchant.revolut.com.
3 operations3 paths33 schemas2 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.2.0
API Version
2026-04-20
Base URL
https://b2b.revolut.com/api/1.0
Authentication
API Key
Resource Areas
1
Authentication & Security 1
Revolut Report runs API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (Api-Key).
By default, every request must be authenticated.
Api-Key — Each Merchant API request must contain an authorization header in the following format: 'Authorization: Bearer ' To use this API, you need to generate API keys…
Paths & Operations 3
Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.
Report runs 3
Use Report runs operations to generate CSV reports of your Merchant account transactions. Choose from the following report types based on your use case: | Report type | Descriptio…
POST
/api/report-runs
Create a report run
createReportRun1 parambody→ 201400401404
GET
/api/report-runs/{report_run_id}
Retrieve a report run
retrieveReportRun2 params→ 200400401404
GET
/api/report-runs/{report_run_id}/file
Download report file
downloadReportFile2 params→ 200400401404
Schemas 33
The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are Report-Run-Csv-Custom (64 properties), Report-Run-Csv-Payout (31 properties), Report-Run-Csv-Payments (26 properties), Report-Run-Csv-Settlement (24 properties). Each schema is shown below with its type and property counts.
Report-Run-Custom-Options
object
Further options to customise the report.
2 properties
Report-Run-Payments-Report
object
A payments report contains all the query information for generating reports of payments associated with a Merchant account, including failed and declined payme…
4 properties3 required
Report-Run-Entity-Types
array
Select source entity families to be included in the report. | Value | Description | | ----- | ----------- | | payment | Include rows originating from payment s…
Report-Run-Payout-Report
object
A payout statement report contains all the query information for generating reports of a selected payout associated with a Merchant account.
4 properties3 required
Report-Run-Type
string
Type of the report. | Report type | Description | | -------------- | ----------- | | settlementreport | All settled transactions associated with a Merchant acc…
Report-Run
object
The ReportRunDetails object contains all information associated with a specific report run, identified by the reportrunid.
3 properties2 required
Icpp-Charge-Id
string
Permanent ID of of the IC++ fee related to a payout transaction. This ID can be obtained from the relatedicppchargeid column of a payout statement report.
Report-Run-Custom-Report
object
A custom report contains all the query information for generating reports of selected transactions associated with a Merchant account.
4 properties3 required
Report-Run-Timezone
string
Defaults to ETC/UTC. Defines the output timezone for all timestamps displayed in the report. Has no effect on from or to parameters.
Report-Run-Currency
string
Select transactions with specific currencies to include in the report. Provide [ISO 4217](https://en.wikipedia.org/wiki/ISO4217) currency code in upper case. :…
Report-Run-To
string
This parameter specifies the end boundary for filtering report data. It accepts ETC/UTC date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO860…
Report-Run-Payout-Filter
object
Filtering parameters to be applied to the report.
1 property1 required
Report-Run-From
string
This parameter specifies the start boundary for filtering report data. It accepts ETC/UTC date and time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO8…
Report-Run-Payments-Options
object
Further options to customise the report.
2 properties
Report-Run-Entity-States
array
Select transactions by state to be included in the report. | Value | Description | | ----- | ----------- | | completed | Include transactions that reached thei…
Report-Run-Csv-Settlement
object
CSV output for settlementreport. Contains settled transactions associated with a Merchant account. The first row is a header row with column names. Subsequent…
24 properties
Report-Run-Payout-Options
object
Further options to customise the report.
2 properties
Report-Run-Csv-Payout
object
CSV output for payoutstatementreport report type. Contains all transactions that contributed to a specific payout. The first row is a header row with column na…
31 properties
Report-Run-Filter
object
Filtering parameters to be applied to the report. :::note For settlementreport and customreport, from and to are evaluated against the transaction createddate,…
6 properties2 required
Report-Run-Icpp-Filter
object
Filtering parameters to be applied to the report.
1 property1 required
Report-Run-Csv-Icpp
object
CSV output for icppfeebreakdownreport report type. Contains IC++ fee components broken down per transaction for a specific IC++ charge. The first row is a head…
19 properties
Payout-Id
string
Permanent payout ID used for payouts operations.
Report-Run-Icpp-Options
object
Further options to customise the report.
2 properties
Report-Run-Csv-Custom
object
CSV output for customreport report type. Contains settled and processing transactions with a configurable set of columns. The first row is a header row with co…
64 properties
Report-Run-Format
string
Format of the generated report file.
Report-Run-Payments-Entity-States
array
Select payments by state to be included in the report. | Value | Description | | ----- | ----------- | | completed | Include payments that completed successful…
Report-Run-Location-Id
string
Select transactions by location ID to be included in the report. :::info For more information, see: [Locations](https://developer.revolut.com/docs/api/merchant…
Error-v2
object
3 properties
Report-Run-Payments-Filter
object
Filtering parameters to be applied to the report. :::note For paymentsreport, from and to are evaluated against the payment createddate. The captureddate colum…
3 properties2 required
Report-Run-Csv-Payments
object
CSV output for paymentsreport report type. Contains all payments including failed and declined ones. The first row is a header row with column names. Subsequen…
26 properties
Report-Run-Icpp-Report
object
A IC++ fee breakdown report contains all the query information for generating reports of fees for each IC++ transaction related to a payout.
4 properties3 required
Report-Run-Settlement-Report
object
A settlement report contains all the query information for generating reports of settled transactions associated with a Merchant account.
4 properties3 required
Report-Run-Settlement-Options
object
Further options to customise the report.
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Revolut Report runs API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
