# Retarus GraphQL Reporting API for Cloud Fax

The Retarus GraphQL Reporting API provides automated, real-time retrieval of usage detail records (UDRs) for your Cloud Fax services. Access comprehensive transmission data, delivery status, and billing information through a standardized GraphQL interface designed for seamless integration.

## Cloud Fax reporting capabilities

The API provides detailed reporting for both inbound and outbound fax transmissions:

| **Fax type** | **Query** | **Description** |
|  --- | --- | --- |
| Cloud Fax Inbound | `faxInUdrReport` | Reception status, delivery tracking, and archiving information |
| Cloud Fax Outbound | `faxOutUdrReport` | Transmission status, call details, and delivery confirmation |


## Available data for Cloud Fax

Your Cloud Fax reports include standardized data structures for operational consistency:

* **Billing and accounting data:** Service accounts, billing codes, cost centers, and usage tracking
* **Call/transmission details:** Connection information, transmission rates, and durations
* **Document information:** Page counts, file sizes, resolution, and MIME types
* **Timestamp tracking:** Creation, processing, delivery, and event timestamps in UTC format


## 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 products, see the [Cross-Product GraphQL Reporting API documentation](/common/graphql-introduction).