Airtm Reports API
# ReportsGenerate detailed financial reports for your Airtm Enterprise account. Reports provide transaction data, audit trails, and downloadable CSV files for accounting and compliance.## How Reports WorkReports are generated asynchronously to handle large datasets efficiently:1. **Create** - Submit report request for specific month/year2. **Monitor** - Check status until completed3. **Download** - Get secure CSV file when ready## Report Types### Transaction ReportsComplete transaction data including all payouts and payins with amounts, fees, recipients, and status information.### Audit ReportsComprehensive audit trails including account balance changes, administrative actions, and system events.## Core Operations### Create ReportGenerate a new report for a specific month and year. Reports are processed asynchronously.### List ReportsGet paginated list of your reports with filtering by type and status.### Get Report DetailsRetrieve information about a specific report including generation status and metadata.### Download Report FileGet secure download URL for completed reports. URLs expire after 1 hour for security.## Report Statuses| Status | Description | Next Steps || ------------ | ------------------ | ------------------- || `PENDING` | Report queued | Wait for processing || `PROCESSING` | Being generated | Monitor status || `COMPLETED` | Ready for download | Download file || `FAILED` | Generation failed | Check error, retry |## Report Contents### CSV FormatReports include comprehensive data with columns for transaction IDs, types, statuses, amounts, fees, recipients, and timestamps.### Data Scope- All transactions for the specified month- Complete fee breakdowns- Currency conversion details- Compliance and regulatory information## Best Practices- Generate reports during off-peak hours when possible- Use monthly ranges for better performance- Download reports immediately after completion- Implement proper retry logic for failed generations- Store downloaded reports securely## Common Issues**Report Stuck in Pending**- Check for high system load- Contact support if stuck over 30 minutes**Empty Reports**- Verify transactions exist for the date range- Check timezone settings**Download URL Expired**- Generate new download URL- URLs expire after 1 hour## Error Handling- **Report Not Found (415042)**: Check report ID- **Report Not Completed (415044)**: Wait for processing to finish- **Invalid Parameters (415054)**: Verify month/year valuesFor complete error reference, see [Reason Codes](#description/reason-codes).## Getting Started1. Set up [authentication](#description/authentication)2. Test report generation in sandbox3. Implement status monitoring4. Set up secure file download## Related Resources- [Payouts](#tag/payouts) - Transaction data included in reports- [Account Management](#tag/me) - Check account details- [Error Codes](#description/reason-codes) - Troubleshoot issues
Airtm Reports API is one of 24 APIs that Airtm publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Reports. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 4 operations across 3 paths, and defines 7 schemas. It is described by OpenAPI 3.2.0, at version 1.155.0.
Requests are made against 2 base URLs: https://api.enterprise.airtm.com/v2, https://api.stg.enterprise.airtm.com/v2.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Airtm Reports API declares
1 security scheme
for authenticating requests.
It accepts HTTP basic authentication (basicAuth).
Paths & Operations 4
Across 3 paths, the API surfaces 4 operations — 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.
Reports Generate detailed financial reports for your Airtm Enterprise account. Reports provide transaction data, audit trails, and downloadable CSV files for accounting and compli…
Schemas 7
The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Report (8 properties), CreateReportRequest (3 properties), Paginated_Report_ (3 properties), ReportFile (1 property). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Airtm 12
Other APIs Airtm publishes across the network.
This is an independent, third-party profile of Airtm Reports API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.