Generate Operation Statement Product Export File
POSTDescription: Initiate a request to retrieve an operation statement product file for the specified date range. Use the returned file_id with the 'storage/files/:id/url' endpoint to get url for download the operation statement in CSV format./v1/reports/operation-statement-product/exports
Request
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- application/json
Body
required
- currency_symbol: Currency symbol.
- merchant_id: Merchant ID.
- value: Operation value.
- topic: Transaction type topic.
- Note: Valid transaction type topics:
- CARD: Card transactions.
- PIX: PIX transactions.
- TED: TED transactions.
- BANK_BILLET: Bank billet transactions.
- CRYPTO: Cryptocurrency transactions.
- P2P: P2P transactions.
- OTHERS: Other types of transactions.
Possible values: [transaction_created_at
]
Default value: transaction_created_at
Page sort attribute.
Possible values: [asc
, desc
]
Default value: desc
Page order.
Possible values: [currency_symbol
, merchant_id
, topic
, value
]
Filter type.
Filter Text.
Start date for the statement (format: YYYY-MM-DD). Filters operations where transaction_created_at >= this date (inclusive).
End date for the statement (format: YYYY-MM-DD). Filters operations where transaction_created_at < this date (exclusive).
Responses
- 201
- 400
- 401
- 422
Operation statement product export generated successfully.
- application/json
- Schema
- Example (from schema)
Schema
Generated file ID.
Possible values: [PENDING
, WAITING_UPLOAD
, READY
, ERROR
]
File state.
File created at.
{
"file_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"file_state": "PENDING",
"created_at": "2025-06-23T19:44:59.121Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.