Get a tenant's monthly report
curl --request GET \
--url https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month} \
--header 'Api-Key: <api-key>'import requests
url = "https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}"
headers = {"Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'Api-Key': '<api-key>'}};
fetch('https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}")
.header("Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"url": "https://storage.googleapis.com/rain-prod-data/teams/037c3597-9b7f-4a97-9712-dced3ec1956d/servicing/reports/monthly/2026/07.csv?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Signature=SIGNATURE",
"expiresAt": "2026-07-01T13:00:00.000Z"
}Reports
Get a tenant's monthly report
Retrieves the monthly report for the specified year and month. The response is a JSON object with a short-lived signed URL ({ url, expiresAt }), not the file itself — download it with curl -o report.csv "<url>". The link expires 1 hour after issuance (expiresAt). Use format=csv (default) or format=json.
GET
/
issuing
/
reports
/
{year}
/
{month}
Get a tenant's monthly report
curl --request GET \
--url https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month} \
--header 'Api-Key: <api-key>'import requests
url = "https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}"
headers = {"Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'Api-Key': '<api-key>'}};
fetch('https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}")
.header("Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-dev.rain.xyz/v1/issuing/reports/{year}/{month}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"url": "https://storage.googleapis.com/rain-prod-data/teams/037c3597-9b7f-4a97-9712-dced3ec1956d/servicing/reports/monthly/2026/07.csv?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Signature=SIGNATURE",
"expiresAt": "2026-07-01T13:00:00.000Z"
}Subtenants
PassincludeSubtenants=true to return a combined report covering the tenant and all of its subtenants. When the parameter is false or omitted, the report contains only the tenant’s own data.
Subtenant API keys automatically receive a subtenant-specific report. You don’t need to set includeSubtenants. The includeSubtenants parameter applies to the csv and json formats.
Example report file
The response is a signedurl. A csv report looks like this:
transactionId,transactionDate,transactionType,status,merchantName,merchantCategoryCode,authorizationAmount,authorizationCurrency,settlementAmount,settlementCurrency,interchangeAmount,cardId,cardLast4,cardholder,isThreeDSecureTransaction,isATMTransaction,isATMPremiumTransaction,visaProductType,tokenRequestorId,walletName,isNetworkAccountVerification,isNetworkChipAuthentication,isInternationalTransaction,foreignExchangeFees,crossBorderFees,merchantCountryCode
123456789-123456789-123456789,2025-12-05T13:23:46.372Z,spend,closed,TARGET STORE #510 ,5310,2460,usd,2460,usd,492000,123456789123456789,8888,John Doe,false,false,false,Classic,1234567890,ApplePay,false,false,false,0,0,US
Authorizations
Path Parameters
Year of the report
Pattern:
^\d{4}$Month of the report, will contain transactions settled in the previous month
Pattern:
^\d{2}$Query Parameters
The format of the report
Available options:
csv, json Include subtenant activity in the report.
Response
A short-lived signed URL to download the report. Issue a GET to url to download the file; the link expires at expiresAt (1 hour after issuance).