Refund detail
The /reports/cashflow-refunds-detail endpoint returns individual refund records for a given period.
GET /reports/cashflow-refunds-detail
Query parameters
| Parameter | Type | Description |
|---|
selected-date | string | Period start date to show refunds for. Required. |
baseCurrency | string | Target currency for conversion. |
interval | string | Aggregation interval. Defaults to month. |
region | string | Filter by region or country codes (space-separated). |
currency | string | Filter by currency codes (space-separated). |
plan | string | Filter by plan group IDs (space-separated). |
data_source | string | Filter by data source ID (space-separated). |
Example response
200 OK
{
"result": {
"list": [
{
"date": "2025-01-10",
"invoice_ref": "in_refund_001",
"customer_id": "cus_123",
"customer_name": "Acme Corp",
"customer_email": "[email protected]",
"amount": 4900,
"amount_base_currency": 4900,
"currency": "usd",
"payment_method": "card",
"description": "Refund - Pro Plan"
}
]
}
}
Response fields
| Field | Type | Description |
|---|
date | string | Refund date |
invoice_ref | string | Invoice reference ID |
customer_id | string | Customer external ID |
customer_name | string | Customer name |
customer_email | string | Customer email |
amount | number | Refund amount in original currency (cents) |
amount_base_currency | number | Refund amount in base currency (cents) |
currency | string | Original payment currency |
payment_method | string | Payment method |
description | string | Refund description |
