---
title: "Per group push time series report"
method: GET
path: "/api/reports/pergroup/series/{group_id}"
tags: ["Reports"]
---

# Per group push time series report

`GET /api/reports/pergroup/series/{group_id}`

## Request

- Base URL: `https://go.urbanairship.com`
- URL: `https://go.urbanairship.com/api/reports/pergroup/series/{group_id}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
  - OAuth 2
    - Client credentials
    - Token URL: `http://oauth2.{domain}.com/token` scopes: `rpt`
- TypeScript: <https://skmtc.dev/airship/apis/airship-api/docs/api/reports/pergroup/series/:group_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the default time series data (hourly precision for 12 hours) for a given group push message. The series begins with the hour in which the push was sent. By specifying the precision without providing a time range, the default number of periods at each precision returned are as follows: Hourly: 12, Daily: 7, Monthly: 3. Results paginate if requesting narrow precision over a long period of time.

## Response `200`

Returned on success.

- PerGroupPushTimeSeriesReport: The response body for per push time series report.
  - `group_id` string, uuid: The UUID representing a specific group push.
  - `app_key` string: The app key for the application.
  - `end` string, date-time: The end [date-time](/developer/rest-api/ua/introduction/#date-time-format) for the report.
  - `precision` 'HOURLY' | 'DAILY' | 'MONTHLY': The precision of the report.
  - `start` string, date-time: The start [date-time](/developer/rest-api/ua/introduction/#date-time-format) for the report.
  - `counts` CountsTimeSeriesObject[]: Array of total count objects, each representing counts within the given [date-time](/developer/rest-api/ua/introduction/#date-time-format) range and precision.
    - `push_platforms` object
      - `all` PlatformObject
        - `direct_responses` integer: The number of direct responses (clicks/app opens) to the notification on this platform as measured by the SDK.
        - `influenced_responses` integer: The number of opens or clicks resulting from your notification (directly or indirectly).
        - `sends` integer: The total number of audience members accounted on the specified platform.
      - `android` PlatformObject
        - `direct_responses` integer: The number of direct responses (clicks/app opens) to the notification on this platform as measured by the SDK.
        - `influenced_responses` integer: The number of opens or clicks resulting from your notification (directly or indirectly).
        - `sends` integer: The total number of audience members accounted on the specified platform.
      - `ios` PlatformObject
        - `direct_responses` integer: The number of direct responses (clicks/app opens) to the notification on this platform as measured by the SDK.
        - `influenced_responses` integer: The number of opens or clicks resulting from your notification (directly or indirectly).
        - `sends` integer: The total number of audience members accounted on the specified platform.
    - `rich_push_platforms` object
      - `all` AllRichPushPlatformsObject
        - `responses` integer: The number of opens or clicks to the notification.
        - `sends` integer: The number of sends for the given push.
    - `time` string, date-time: The [date-time](/developer/rest-api/ua/introduction/#date-time-format) when the count was tallied and stored.

## Changes

- **2026-02-20** `e2bd980cb50b`: 2 info
  - added `subschema #2, subschema #3` to the response body `allOf` list for the response status `200`
  - removed `subschema #2, subschema #3` from the response body `allOf` list for the response status `200`

[Operation history](https://skmtc.dev/airship/apis/airship-api/changes/api/reports/pergroup/series/:group_id/get.md)

---

[API](https://skmtc.dev/airship/apis/airship-api.md) - [All operations](https://skmtc.dev/airship/apis/airship-api/llms.txt) - [OpenAPI document](https://skmtc.dev/airship/apis/airship-api/revisions/bd6ab947117a?raw)