Request Wallet Statement (New)

Overview

Request an official wallet statement for a defined period across one or more wallets. Because large date ranges and high-volume transaction accounts require background compilation time, the request is accepted asynchronously (202 Accepted) and processed by our queuing engine.

When generation completes, the statement is formatted in the requested file type (csv or pdf) and can optionally be emailed to the specified corporate address.

Resource Access

• HTTP Method: POST
• Endpoint: /banking/ibans/v2/statement/export
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Authorization	Bearer {access_token}	Yes	JWT Bearer access token
Content-Type	application/json	Yes	Request payload format
Accept	application/json	Yes	Response payload format
x-api-key	string	No	Optional API key

Query Parameters

Parameter	Type	Required	Description
since	string (ISO Date)	No	Limit transactions by "from" start date in ISO format (e.g. 2024-12-12T00:00:00.000Z).
till	string (ISO Date)	No	Limit transactions by "to" end date in ISO format (e.g. 2024-12-31T23:59:59.000Z).
format	string	No	Statement export format: csv or pdf (default: csv).

Request Body

Request Fields

Field	Type	Required	Description
walletIds	array of numbers	No	Array of wallet IDs to include in the statement export (e.g. [8599, 90033]).
email	string	No	Optional email address where the statement download link will be dispatched once ready.

Request Example

{
  "walletIds": [8599, 90033],
  "email": "finance@company.com"
}

Response

Success Response (202 Accepted)

{
  "message": "The statement export request has been accepted and queued for processing.",
  "status": "QUEUED"
}

Error Responses

• 400 Bad Request: Invalid date range, unsupported format, or invalid wallet IDs.
• 401 Unauthorized: Missing or expired Bearer token.
• 403 Forbidden: Insufficient permissions to access records for the specified wallets.
• 404 Not Found: One or more specified wallet IDs do not exist.
• 500 Internal Server Error: Background worker or platform error.

Code Examples

Base URL

Production: https://api.ahrvo.network
Staging:    https://gateway.ahrvo.network

cURL

curl -X POST \
  'https://gateway.ahrvo.network/banking/ibans/v2/statement/export?since=2024-12-01T00:00:00.000Z&till=2024-12-31T23:59:59.000Z&format=csv' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "walletIds": [8599, 90033],
    "email": "finance@company.com"
  }'

Python

import requests

url = "https://gateway.ahrvo.network/banking/ibans/v2/statement/export"
params = {
    "since": "2024-12-01T00:00:00.000Z",
    "till": "2024-12-31T23:59:59.000Z",
    "format": "csv"
}
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}
payload = {
    "walletIds": [8599, 90033],
    "email": "finance@company.com"
}

response = requests.post(url, params=params, json=payload, headers=headers)
print(response.status_code, response.json())

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://gateway.ahrvo.network/banking/ibans/v2/statement/export';
const headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  'Content-Type': 'application/json'
};
const params = {
  since: '2024-12-01T00:00:00.000Z',
  till: '2024-12-31T23:59:59.000Z',
  format: 'csv'
};
const payload = {
  walletIds: [8599, 90033],
  email: 'finance@company.com'
};

axios.post(url, payload, { headers, params })
  .then(res => console.log(res.status, res.data))
  .catch(err => console.error(err.response ? err.response.data : err.message));

Interactive API Explorer