Saltar al contenido principal
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

​
Parámetros de consulta

​
startDate
string
Cota inferior inclusiva sobre createdAt (ISO 8601). Opcional.
​
endDate
string
Cota superior inclusiva sobre createdAt (ISO 8601). Opcional.
​
format
string
predeterminado:"csv"
Formato de salida: csv (por defecto) o json.
endDate es un timestamp, no un día calendario: 2024-01-31 equivale a 2024-01-31T00:00:00Z y excluye ese día — para incluir el día completo, envía 2024-01-31T23:59:59Z. Cuando se envían ambas fechas, startDate debe ser anterior o igual a endDate; de lo contrario la API responde 400 Bad Request.

​
Respuesta

La respuesta es una descarga de archivo (Content-Disposition: attachment; filename="payouts_<startDate>_<endDate>.<format>") y se transmite en streaming, por lo que mantiene un uso de memoria eficiente en rangos de fechas grandes. format=csv (por defecto) → Content-Type: text/csv. La primera línea es la fila de encabezados, seguida de una fila por payout. Los valores se escapan según RFC 4180. Columnas, en orden:
ColumnaDescripción
idIdentificador del payout.
externalIdTu referencia externa, si la hay.
stateEstado actual del payout.
onBehalfOfUsuario/entidad para quien se hizo el payout.
amountMonto del payout.
developerFeeComisión de desarrollador aplicada, si la hay.
currencyMoneda del payout.
destinationTypeTipo de destino (por ejemplo, bank, crypto_wallet, qr_code).
errorReasonMotivo de la falla, si el payout falló.
partnerNameNombre del partner de liquidación.
partnerTransactionIdID de transacción del lado del partner.
partnerStatusEstado del lado del partner.
createdAtTimestamp de creación (ISO 8601).
updatedAtTimestamp de última actualización (ISO 8601).
format=json → Content-Type: application/json. Un envoltorio con las filas en data y la cantidad de registros emitidos en 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