---
title: "Request a cross-border transactions report"
method: POST
path: "/irt/v1/reports"
tags: ["IRT"]
---

# Request a cross-border transactions report

`POST /irt/v1/reports`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

Requests an on-demand report of your cross-border transactions for [from, to] (both inclusive), emailed to the given addresses once generated. Accepted immediately; generation and delivery happen asynchronously in the reports service.

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Request body

- RequestCrossBorderReportDto
  - `from` string, required: Inclusive start of the reported period, ISO 8601 date.
  - `to` string, required: Inclusive end of the reported period, ISO 8601 date.
  - `emails` string[], required: Addresses the finished report is emailed to.

## Response `202`

The request was accepted; the report is generated and emailed asynchronously.

## Other responses

- `401`: Wrong credentials
- `403`: Forbidden
- `422`: Unprocessable Entity
- `429`: ThrottlerException: Too Many Requests
- `500`: Internal error
- `503`: Service unavailable

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/irt/v1/reports/post.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)