# Retarus GraphQL Reporting API for SMS

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

## SMS reporting capabilities

The API provides detailed reporting for outbound SMS transmissions:

| **SMS type** | **Query** | **Description** |
|  --- | --- | --- |
| SMS Outbound | `smsOutUdrReport` | Message delivery status, recipient tracking, and billing data |


## Available data for SMS

Your SMS reports include standardized data structures for operational consistency:

* Billing and accounting data: Service accounts, billing codes, cost centers, and usage tracking
* Transmission details: Message routing, delivery status, and recipient information
* Message information: Content length, character encoding, and message segmentation
* 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).