# Retarus GraphQL Reporting API for Transactional Email

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.

## Transactional Email reporting capabilities

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 |


## Available data for Transactional Email

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


## Data retention & query limits

| **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.

## API reference & implementation guide

For detailed query examples, field definitions, authentication, pagination, and integration patterns across all Retarus services, see the [Cross-Product GraphQL Reporting API documentation](/common/graphql-introduction).