Specifying a Date Range

Relative date ranges

Report queries have a date_range field for specifying the dates for which to include data in the report. The following values can be specified for date_range:

  • TODAY
  • YESTERDAY
  • MONTH_TO_DATE
  • YEAR_TO_DATE
  • LAST_7_DAYS
  • LAST_30_DAYS
  • CUSTOM

Note that the default date range if none is specified is CUSTOM.

Custom date ranges

When date_range is set to CUSTOM or is unspecified, you must set start_date and end_date to the (inclusive) start and end dates of the report range.

In your API request's query parameters, the start date parameters will look like this:

startDate.year=2021&startDate.month=3&startDate.day=1

Similarly, the end date parameters will look like this:

endDate.year=2021&endDate.month=3&endDate.day=3

Next steps