---
title: TimeRange
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/timerange
---

# TimeRange

Date range, time zone, and granularity settings for reporting requests.

## Declaration

```data
object TimeRange
```

## Properties

start: The start date in YYYY-MM-DD format. The range is inclusive of this date. end: The end date in YYYY-MM-DD format. The range is inclusive of this date. timeZone: The time zone for the report date range. The default is ORTZ (org timezone). Both ORTZ and UTC are supported for all reports except search term-level, which only supports ORTZ. granularity: Time period breakdown for granularMetrics in the response. When specified, the response includes granularMetrics broken down by this period. Possible values: HOURLY, DAILY, WEEKLY, MONTHLY. HOURLY granularity is not supported for ad-level or search term-level reports.

## Discussion

Discussion The TimeRange defines the date window, timezone, and optional time-series breakdown for a reporting request. Example {   "start": "2025-01-01",   "end": "2025-01-10",   "timeZone": "ORTZ",   "granularity": "DAILY" }

## See Also

- [Filter](apple-ads-platform-api/filter.md)
- [Sorting](apple-ads-platform-api/sorting.md)
- [RequestPagination](apple-ads-platform-api/requestpagination.md)
- [ReportingMoney](apple-ads-platform-api/reportingmoney.md)
- [ReportingBidStrategy](apple-ads-platform-api/reportingbidstrategy.md)
- [ReportingCampaignMin](apple-ads-platform-api/reportingcampaignmin.md)
- [ReportingAdGroupMin](apple-ads-platform-api/reportingadgroupmin.md)
- [ReportingCreativeSpec](apple-ads-platform-api/reportingcreativespec.md)
- [ReportingDestination](apple-ads-platform-api/reportingdestination.md)
- [ReportingKeyword](apple-ads-platform-api/reportingkeyword.md)
- [ReportingSearchTerm](apple-ads-platform-api/reportingsearchterm.md)
- [ActionMetrics](apple-ads-platform-api/actionmetrics.md)
- [CostMetrics](apple-ads-platform-api/costmetrics.md)
- [RateMetrics](apple-ads-platform-api/ratemetrics.md)
- [ReportingAdChannelType](apple-ads-platform-api/reportingadchanneltype.md)