Create a Report

POST/reports

This endpoint requests generation of a report. Report generation is asynchronous: the response returns immediately with a pending status, and the report is delivered via the chosen delivery channel once ready. Supply an x-idempotency-key header to safely retry without creating duplicate reports.

Header Parameters

x-idempotency-keystring

Unique key to make report creation idempotent across retries. Can be any string; we recommend a V4 UUID or another random string with enough entropy to avoid collisions.

Body application/json

type"fp_account_statement"required

The type of report to generate.

from_datestringrequired

Inclusive report start date in ISO 8601 format. Accepts a date (2026-06-01) or a full datetime (2026-06-01T00:00:00Z). A date-only value (no offset) is interpreted as UTC and normalized to the start of that UTC day; a datetime is used with the offset it carries. To use another timezone, include an explicit offset (e.g. 2026-06-01T00:00:00+08:00). The report period is the half-open interval [from_date, to_date).

to_datestringrequired

Exclusive report end date in ISO 8601 format — up to but not including this value. Accepts a date (2026-07-01) or a full datetime (2026-07-01T00:00:00Z). A date-only value (no offset) is interpreted as UTC and normalized to the start of that UTC day; a datetime is used with the offset it carries. To use another timezone, include an explicit offset (e.g. 2026-06-01T00:00:00+08:00). Example: from_date=2026-06-01 with to_date=2026-07-01 covers all of June.

delivery_channel"email" | "webhook"required

How the completed report is delivered.

Response

Accepted

idstring<uuid>

status"pending" | "error" | "completed"

delivery_channel"email" | "webhook"

sent_atstring<date-time>

When the report was delivered via the chosen delivery_channel. Null until delivery has succeeded (a completed report may still have a null sent_at).

created_atstring<date-time>

updated_atstring<date-time>

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

curl -X POST "https://api.uat.triple-a.io/api/fiat-payout/v1/reports" \ -H "Content-Type: application/json" \ -H "x-idempotency-key: <x-idempotency-key>" \ -H "Authorization: Bearer <token>" \ -d '{ "type": "fp_account_statement", "from_date": "2026-06-01", "to_date": "2026-07-01", "delivery_channel": "email" }'

const response = await fetch(`https://api.uat.triple-a.io/api/fiat-payout/v1/reports`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify({ "type": "fp_account_statement", "from_date": "2026-06-01", "to_date": "2026-07-01", "delivery_channel": "email" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/reports", headers={ "Authorization": "Bearer <token>" }, json={ "type": "fp_account_statement", "from_date": "2026-06-01", "to_date": "2026-07-01", "delivery_channel": "email" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.uat.triple-a.io/api/fiat-payout/v1/reports"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer <token>"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "type": "fp_account_statement", "from_date": "2026-06-01", "to_date": "2026-07-01", "delivery_channel": "email" }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/reports", strings.NewReader(`{ "type": "fp_account_statement", "from_date": "2026-06-01", "to_date": "2026-07-01", "delivery_channel": "email" }`)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.uat.triple-a.io/api/fiat-payout/v1/reports")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"type\": \"fp_account_statement\",\n \"from_date\": \"2026-06-01\",\n \"to_date\": \"2026-07-01\",\n \"delivery_channel\": \"email\"\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.uat.triple-a.io/api/fiat-payout/v1/reports") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer <token>" request.body = "{\n \"type\": \"fp_account_statement\",\n \"from_date\": \"2026-06-01\",\n \"to_date\": \"2026-07-01\",\n \"delivery_channel\": \"email\"\n}" response = http.request(request) puts response.body

{ "id": "00000000-0000-0000-0000-000000000000", "status": "pending", "delivery_channel": "email", "sent_at": "1970-01-01T00:00:00.000Z", "created_at": "1970-01-01T00:00:00.000Z", "updated_at": "1970-01-01T00:00:00.000Z" }