# Airtm Reports API

**Canonical:** https://apis.io/apis/airtm/airtm-reports-api/  
**Provider:** Airtm — https://apis.io/providers/airtm/  
**Base URL:** https://api.enterprise.airtm.com/v2  
**Documentation:** https://docs.airtm.com/

Airtm Reports API is one of 24 APIs that [Airtm](https://apis.io/providers/airtm/) publishes on the [APIs.io](https://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.

# Reports Generate detailed financial reports for your Airtm Enterprise account. Reports provide transaction data, audit trails, and downloadable CSV files for accounting and compliance. ## How Reports Work Reports are generated asynchronously to handle large datasets efficiently: 1. **Create** - Submit report request for specific month/year 2. **Monitor** - Check status until completed 3. **Download** - Get secure CSV file when ready ## Report Types ### Transaction Reports Complete transaction data including all payouts and payins with amounts, fees, recipients, and status information. ### Audit Reports Comprehensive audit trails including account balance changes, administrative actions, and system events. ## Core Operations ### Create Report Generate a new report for a specific month and year. Reports are processed asynchronously. ### List Reports Get paginated list of your reports with filtering by type and status. ### Get Report Details Retrieve information about a specific report including generation status and metadata. ### Download Report File Get 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 Format Reports 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 values For complete error reference, see [Reason Codes](#description/reason-codes). ## Getting Started 1. Set up [authentication](#description/authentication) 2. Test report generation in sandbox 3. Implement status monitoring 4. 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

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/airtm/refs/heads/main/openapi/airtm-reports-api-openapi.yml
- **Documentation** — https://docs.airtm.com/
- **APIReference** — https://docs.airtm.com/
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/airtm/refs/heads/main/asyncapi/airtm-webhooks.yml

## Other Airtm APIs (12)

- [Airtm Wallet Resource (Connect) API](https://apis.io/apis/airtm/airtm-wallet-resource-connect-api/)
- [Airtm Account Status API](https://apis.io/apis/airtm/airtm-account-status-api/)
- [Airtm API Keys API](https://apis.io/apis/airtm/airtm-apikeys-api/)
- [Airtm Bulk Payments API](https://apis.io/apis/airtm/airtm-bulk-payments-api/)
- [Airtm Bulk Payouts API](https://apis.io/apis/airtm/airtm-bulk-payouts-api/)
- [Airtm Deposits API](https://apis.io/apis/airtm/airtm-deposits-api/)
- [Airtm Embedded Catalog API](https://apis.io/apis/airtm/airtm-embedded-catalog-api/)
- [Airtm Embedded Quotes API](https://apis.io/apis/airtm/airtm-embedded-quotes-api/)
- [Airtm Embedded Receivers API](https://apis.io/apis/airtm/airtm-embedded-receivers-api/)
- [Airtm Embedded Senders API](https://apis.io/apis/airtm/airtm-embedded-senders-api/)
- [Airtm Embedded Transactions API](https://apis.io/apis/airtm/airtm-embedded-transactions-api/)
- [Airtm External Bank Account API](https://apis.io/apis/airtm/airtm-external-bank-account-api/)

## Tags

Reports

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/airtm/airtm-reports-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/airtm/.