---
title: "App Store Connect by Device"
method: GET
path: "/accounts/ios/reports/devices"
tags: ["App Store Connect"]
---

# App Store Connect by Device

`GET /accounts/ios/reports/devices`

## Request

- Base URL: `https://public-api.apptweak.com/api/public/integrations`
- URL: `https://public-api.apptweak.com/api/public/integrations/accounts/ios/reports/devices`
- Auth: API key in header `x-apptweak-key`

The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak with a breakdown by device. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>credits/request</th></tr></thead> <tbody> <tr><td><b>property object</b></td><td>Hash containing the values of the property, the start date and end date of the report.</td><td>1</td></tr> </tbody> </table> The response for the request will be a JSON which contains all the info related to the selected property, grouped by app id, country code and device, without pagination. Crashes are not available by country and are therefore returned under the `ww` country key.

## Query parameters

- `id` string, required
- `property` 'impressions-total' | 'impressions-total-unique' | 'page-view-count' | 'page-view-unique' | 'units' | 'iap' | 'sales' | 'paying-users' | 'installs' | 'sessions' | 'active-devices' | 'rolling-active-devices' | 'redownloads' | 'total-downloads' | 'deletions' | 'crashes', required
- `devices` string
- `apps` string
- `countries` string
- `start_date` string
- `end_date` string

## Response `200`

Successful response.

- object
  - `result` object
  - `metadata` ResponseMetadata: Standard response envelope: the request as the API parsed it, the credits actually charged (`cost`), and what the call could have cost had every datapoint been available (`max_credit_cost`). Every endpoint of this API returns it unchanged.
    - `request` object
      - `path` string: The path that was called.
      - `params` object, nullable: The query as the API parsed it, with defaults applied.
      - `cost` integer: Credits actually charged for this call.
      - `max_credit_cost` integer: Credits the call could have cost if every datapoint requested had been available.
      - `status` integer: HTTP status of the response.
    - `response` object, nullable: Endpoint-specific notes; null when there are none.

## Other responses

- `401`: Unauthorized. Unknown or missing API token.
- `403`: Forbidden. Returned when the API plan does not include integration data access, when there are not enough credits to perform the request, when one of the requested apps is not owned by the connected account, or when the requested resource does not belong to the requester's account.
- `422`: Validation error. Returned when a parameter is invalid.

---

[API](https://skmtc.dev/apptweak/apis/console-data-api.md) - [All operations](https://skmtc.dev/apptweak/apis/console-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apptweak/apis/console-data-api/revisions/2e220a518664?raw)