Skip to main content
GET
/
v1
/
payouts
/
export
curl --location --request GET 'https://stablecoin-api.sandbox.getmeru.com/v1/payouts/export?startDate=2024-01-01T00:00:00Z&endDate=2024-01-31T23:59:59Z&format=csv' \
--header 'api-key: <api-key>' \
--output payouts_2024-01.csv

id,externalId,state,onBehalfOf,amount,developerFee,currency,destinationType,errorReason,partnerName,partnerTransactionId,partnerStatus,createdAt,updatedAt
3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1,ext-001,completed,user-123,1000,2.5,cop,bank,,Bridge,tx_abc123,settled,2024-01-15T10:00:00Z,2024-01-15T10:25:00Z

​
Query Params

​
startDate
string
Inclusive lower bound on createdAt (ISO 8601). Optional.
​
endDate
string
Inclusive upper bound on createdAt (ISO 8601). Optional.
​
format
string
default:"csv"
Output format: csv (default) or json.
endDate is a timestamp, not a calendar day: 2024-01-31 resolves to 2024-01-31T00:00:00Z and excludes that day — to include the full day, pass 2024-01-31T23:59:59Z. When both dates are provided, startDate must be before or equal to endDate, otherwise the API responds with 400 Bad Request.

​
Response

The response is a file download (Content-Disposition: attachment; filename="payouts_<startDate>_<endDate>.<format>") and is streamed, so it stays memory-efficient over large date ranges. format=csv (default) → Content-Type: text/csv. The first line is the header row, then one row per payout. Values are RFC 4180-escaped. Columns, in order:
ColumnDescription
idPayout identifier.
externalIdYour external reference, if any.
stateCurrent payout state.
onBehalfOfEnd user/entity the payout was made for.
amountPayout amount.
developerFeeDeveloper fee applied, if any.
currencyPayout currency.
destinationTypeDestination type (e.g. bank, crypto_wallet, qr_code).
errorReasonFailure reason, if the payout failed.
partnerNameSettlement partner name.
partnerTransactionIdPartner-side transaction id.
partnerStatusPartner-side status.
createdAtISO 8601 creation timestamp.
updatedAtISO 8601 last-update timestamp.
format=json → Content-Type: application/json. An envelope with the rows in data and the number of records emitted in count. 
curl --location --request GET 'https://stablecoin-api.sandbox.getmeru.com/v1/payouts/export?startDate=2024-01-01T00:00:00Z&endDate=2024-01-31T23:59:59Z&format=csv' \
--header 'api-key: <api-key>' \
--output payouts_2024-01.csv

id,externalId,state,onBehalfOf,amount,developerFee,currency,destinationType,errorReason,partnerName,partnerTransactionId,partnerStatus,createdAt,updatedAt
3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1,ext-001,completed,user-123,1000,2.5,cop,bank,,Bridge,tx_abc123,settled,2024-01-15T10:00:00Z,2024-01-15T10:25:00Z