The Retarus GraphQL Reporting API provides automated, real-time retrieval of usage detail records (UDRs) and event data for your Transactional Email service. Access comprehensive delivery status, recipient tracking, and engagement metrics through a standardized GraphQL interface designed for seamless integration.
The API provides two types of reporting data for your email communications:
| Report Type | Query | Description |
|---|---|---|
| Email Delivery | transactionalEmailUdrReport | Email delivery status, recipient information, and metadata |
| Email Events | transactionalEmailEventReport | Email engagement tracking for opens, clicks, and interactions |
Your Transactional Email reports include standardized data structures for operational consistency:
- Billing and accounting data: Service accounts, billing codes, cost centers, and usage tracking
- Transmission details: Connection information, delivery rates, and processing times
- Document information: Message sizes, attachment details, and MIME types
- Timestamp tracking: Creation, processing, delivery, and event timestamps in UTC format
- Engagement metrics: Email opens, link clicks, and recipient interactions
| Limit Type | Duration | Description |
|---|---|---|
| Maximum Query Duration | 45 days | Maximum time span for a single API call |
| Maximum History | 90 days | Maximum historical data retention period |
If you need data spanning more than 45 days, split your request into multiple API calls with smaller date ranges.
For detailed query examples, field definitions, authentication, pagination, and integration patterns across all Retarus services, see the Cross-Product GraphQL Reporting API documentation.