> For the complete documentation index, see [llms.txt](https://help.branch.io/llms.txt).

# Cohort API

The Cohort API lets you programmatically query and export Cohort analytics.

[Read the Cohort API overview](https://help.branch.io/apidocs/cohort/overview.md)

## Get export download status

`GET https://api2.branch.io/v2/analytics/{job_id}`

This endpoint provisions querying and exporting Cohort analytics.

### Parameters

- `app_id` (string, query, required) — Unique identifier for the Branch app of the requested data. Either appId or organization_id is required.
- `job_id` (string, path, required) — Unique identifier for the job. Obtained from the POST Export Cohort analytics API.
- `format` (enum, query) — Format of the returned data: json or csv. One of `csv`, `json`.

### Responses

- `200` — Status of aggregate export.
- `400` — Bad request—typically an invalid or missing credential or parameter.
- `429` — Rate limit exceeded—reduce request frequency and retry.

### Returns

Status of aggregate export. Returns `400` and `429` on failure — see the response panel for the error shape.

### Example request

```bash
curl 'https://api2.branch.io/v2/analytics/0000-XXxx?app_id=123456789012345680' \
  --request GET \
  --header 'Access-Token: <Access-Token>'
```

### Example responses

`200`

```json
{
  "status": "FINISHED",
  "code": 200,
  "response_url": "https://api2.branch.io/v2/analytics/a1b2c3d4",
  "error_message": "N/A"
}
```

`400`

```json
{
  "error": {
    "message": "Authentication failed.",
    "code": 400
  }
}
```

`429`

```json
{
  "error": {
    "code": 429,
    "message": "Rate limit reached."
  }
}
```

## Export Cohort analytics

`POST https://api2.branch.io/v2/analytics`

This endpoint provisions querying and exporting Cohort analytics.

### Parameters

- `app_id` (string, query, required) — Unique identifier for the Branch app of the requested data. Either appId or organization_id is required.
- `data_source` (enum, required) — A string value representing the cohort type. One of `install_cohort`, `reengagement_cohort`.
- `end_date` (string, required) — The end of the interval time range represented as an ISO-8601 complete date.
- `granularity_band_count` (integer, required) — Number of time units since the cohort event to return to the user.
- `measures` (array of enum, required) — The cohort measures to return. The limit is 3. See [Measure](https://help.branch.io/apidocs/cohort/overview.md#measures) for the complete list. One of `OPEN`, `users`, `Retention`, `ARPPU`, `LTV`, `ARPU`, `revenue`, `PURCHASE`, `ADD_TO_CART`, `ADD_TO_WISHLIST`, `VIEW_CART`, `INITIATE_PURCHASE`, `ADD_PAYMENT_INFO`, `SPEND_CREDITS`, `RESERVE`, `CLICK_AD`, `VIEW_AD`, `SEARCH`, `VIEW_ITEM`, `VIEW_ITEMS`, `RATE`, `SHARE`, `COMPLETE_REGISTRATION`, `COMPLETE_TUTORIAL`, `ACHIEVE_LEVEL`, `UNLOCK_ACHIEVEMENT`, `INVITE`, `LOGIN`, `SUBSCRIBE`, `START_TRIAL`, `cost`, `GROSS_PROFIT`, `ROI`, `ROAS`, `eCPA`.
- `start_date` (string, required) — The start of the interval time range represented as an ISO-8601 complete date.
- `cumulative` (boolean) — If true, sum across bands so that a given band value is the sum of all preceding values plus the band value.
- `dimensions` (array of enum) — An array representing the dimensions to group by. The limit is 11. See [Dimensions](https://help.branch.io/apidocs/cohort/overview.md#dimensions) for the complete list. One of `install_activity_attributed`, `install_activity_event_name`, `install_activity_touch_type`, `install_activity_touch_data_tilde_campaign_id`, `install_activity_touch_data_tilde_campaign`, `install_activity_touch_data_tilde_channel`, `install_activity_touch_data_tilde_feature`, `install_activity_touch_data_tilde_stage`, `install_activity_touch_data_tilde_tags`, `install_activity_touch_data_tilde_advertising_partner_name`, `install_activity_touch_data_dollar_3p`, `install_activity_touch_data_tilde_secondary_publisher`, `install_activity_touch_data_tilde_creative_name`, `install_activity_touch_data_tilde_ad_id`, `install_activity_touch_data_tilde_ad_set_id`, `install_activity_touch_data_tilde_ad_set_name`, `install_activity_touch_data_tilde_ad_name`, `install_activity_touch_data_tilde_keyword`, `install_activity_touch_data_tilde_journey_name`, `install_activity_touch_data_tilde_view_name`, `install_activity_touch_data_plus_referring_domain`, `install_activity_touch_data_plus_via_features`, `install_activity_touch_data_plus_web_format`, `install_activity_data_os`, `install_activity_data_environment`, `install_activity_data_platform`, `install_activity_data_country_code`, `install_activity_data_has_app`, `install_activity_data_has_clicked_email`, `install_activity_data_has_clicked_ad`, `install_activity_timezone_adjusted_day`, `install_activity_touch_data_tilde_placement`, `install_activity_data_device_type`, `install_activity_touch_data_tilde_sub_site_name`, `install_activity_data_brand`, `install_activity_data_geo_country_en`, `install_activity_data_model`, `install_activity_data_geo_region_en`, `install_activity_touch_data_tilde_customer_secondary_publisher`, `install_activity_touch_data_tilde_customer_placement`, `install_activity_touch_data_tilde_customer_sub_site_name`, `install_activity_touch_data_tilde_customer_campaign`, `install_activity_touch_data_tilde_customer_ad_set_name`, `install_activity_touch_data_tilde_customer_ad_name`, `install_activity_touch_data_tilde_customer_keyword`, `install_activity_touch_data_tilde_agency_id`, `install_activity_touch_data_tilde_agency`, `customer_event_alias`, `reengagement_activity_attributed`, `reengagement_activity_event_name`, `reengagement_activity_touch_type`, `reengagement_activity_touch_data_tilde_campaign_id`, `reengagement_activity_touch_data_tilde_campaign`, `reengagement_activity_touch_data_tilde_channel`, `reengagement_activity_touch_data_tilde_feature`, `reengagement_activity_touch_data_tilde_stage`, `reengagement_activity_touch_data_tilde_tags`, `reengagement_activity_touch_data_tilde_advertising_partner_name`, `reengagement_activity_touch_data_dollar_3p`, `reengagement_activity_touch_data_tilde_secondary_publisher`, `reengagement_activity_touch_data_tilde_creative_name`, `reengagement_activity_touch_data_tilde_ad_id`, `reengagement_activity_touch_data_tilde_ad_set_id`, `reengagement_activity_touch_data_tilde_ad_set_name`, `reengagement_activity_touch_data_tilde_ad_name`, `reengagement_activity_touch_data_tilde_keyword`, `reengagement_activity_touch_data_tilde_journey_name`, `reengagement_activity_touch_data_tilde_view_name`, `reengagement_activity_touch_data_plus_referring_domain`, `reengagement_activity_touch_data_plus_via_features`, `reengagement_activity_touch_data_plus_web_format`, `reengagement_activity_data_os`, `reengagement_activity_data_environment`, `reengagement_activity_data_platform`, `reengagement_activity_data_country_code`, `reengagement_activity_data_has_app`, `reengagement_activity_data_has_clicked_email`, `reengagement_activity_data_has_clicked_ad`, `reengagement_activity_timezone_adjusted_day`, `reengagement_activity_touch_data_tilde_placement`, `reengagement_activity_data_device_type`, `reengagement_activity_touch_data_tilde_sub_site_name`, `reengagement_activity_data_brand`, `reengagement_activity_data_geo_country_en`, `reengagement_activity_data_model`, `reengagement_activity_data_geo_region_en`, `reengagement_activity_touch_data_tilde_customer_secondary_publisher`, `reengagement_activity_touch_data_tilde_customer_placement`, `reengagement_activity_touch_data_tilde_customer_sub_site_name`, `reengagement_activity_touch_data_tilde_customer_campaign`, `reengagement_activity_touch_data_tilde_customer_ad_set_name`, `reengagement_activity_touch_data_tilde_customer_ad_name`, `reengagement_activity_touch_data_tilde_customer_keyword`, `reengagement_activity_touch_data_tilde_agency_id`, `reengagement_activity_touch_data_tilde_agency`, `user_data_platform`, `user_data_environment`, `user_data_geo_country_code`, `user_data_os`, `user_data_has_app`, `user_data_standard_events_completed`, `user_data_custom_events_completed`, `user_data_has_clicked_ad`, `user_data_has_clicked_email`, `user_data_brand`, `user_data_device_type`, `user_data_model`, `app_id`.
- `enable_install_recalculation` (boolean) — If true, then Branch will dedupe unattributed installs caused by duplicate events from non-opt-in users coming from paid ads (resulting from [iOS 14.5 privacy changes](https://help.branch.io/marketer-hub/category/ios-14-faqs.md)).
- `filter` (object) — Keys are the same as dimensions. Values are an array of values to match for the dimension. An object defining filters to match or disallow certain values. Example: ["install_activity_touch_data_tilde_campaign": ["A4G"]] 
- `filter.app_id` (array of string)
- `filter.install_activity_attributed` (array of enum) — One of `true`, `false`.
- `filter.install_activity_event_name` (array of string)
- `filter.install_activity_touch_type` (array of enum) — One of `CLICK`, `IMPRESSION`, `WEB_TO_APP_AUTO_REDIRECT`.
- `filter.install_activity_touch_data_tilde_campaign_id` (array of string)
- `filter.install_activity_touch_data_tilde_campaign` (array of string)
- `filter.install_activity_touch_data_tilde_channel` (array of string)
- `filter.install_activity_touch_data_tilde_feature` (array of string)
- `filter.install_activity_touch_data_tilde_stage` (array of string)
- `filter.install_activity_touch_data_tilde_tags` (array of string)
- `filter.install_activity_touch_data_tilde_advertising_partner_name` (array of string)
- `filter.install_activity_touch_data_dollar_3p` (array of string)
- `filter.install_activity_touch_data_tilde_secondary_publisher` (array of string)
- `filter.install_activity_touch_data_tilde_creative_name` (array of string)
- `filter.install_activity_touch_data_tilde_ad_id` (array of string)
- `filter.install_activity_touch_data_tilde_ad_set_id` (array of string)
- `filter.install_activity_touch_data_tilde_ad_set_name` (array of string)
- `filter.install_activity_touch_data_tilde_ad_name` (array of string)
- `filter.install_activity_touch_data_tilde_keyword` (array of string)
- `filter.install_activity_touch_data_tilde_journey_name` (array of string)
- `filter.install_activity_touch_data_tilde_view_name` (array of string)
- `filter.install_activity_touch_data_plus_referring_domain` (array of string)
- `filter.install_activity_touch_data_plus_via_features` (array of enum) — One of `EMAIL`, `ADS`, `DESKTOP_JOURNEYS`, `MOBILE_JOURNEYS`, `DESKTOP_DEEPVIEWS`, `MOBILE_DEEPVIEWS`, `SOCIAL`, `QUICK_LINKS`.
- `filter.install_activity_touch_data_plus_web_format` (array of enum) — One of `AMP`, `INSTANT_ARTICLES`.
- `filter.install_activity_data_os` (array of enum) — One of `AMAZON_FIRE`, `AMAZON_FIRE_TV`, `ANDROID`, `BADA`, `BEOS`, `BLACKBERRY`, `BSD`, `CENTOS`, `CHROMIUM_OS`, `DEBIAN`, `DRAGONFLY`, `FEDORA`, `FIREFOX_OS`, `FREEBSD`, `GENTOO`, `GNU`, `IOS`, `JOLI`, `KUBUNTU`, `LINUX`, `MAC_OS`, `MANDRIVA`, `MEEGO`, `MINT`, `NETBSD`, `NINTENDO`, `OPENBSD`, `OS_2`, `OTHER`, `PLAYSTATION`, `RIM_TABLET_OS`, `ROBOTS`, `SAILFISH`, `SLACKWARE`, `SOLARIS`, `SUSE`, `SYMBIAN`, `TIZEN`, `TVOS`, `UBUNTU`, `UNIX`, `WINDOWS`, `WINDOWS_PHONE`, `ZENWALK`, `ROKU`, `SAMSUNG`, `ANDROID_TV`, `LG`, `PANASONIC`.
- `filter.install_activity_data_environment` (array of enum) — One of `FULL_WEB`, `FULL_APP`, `IMESSAGE_APP`, `INSTANT_APP`, `TV_WEB`, `TV_APP`.
- `filter.install_activity_data_platform` (array of enum) — One of `ANDROID_APP`, `ANDROID_TV`, `ANDROID_WEB`, `DESKTOP_WEB`, `FIRE_APP`, `IOS_APP`, `IOS_TV`, `IOS_WEB`, `MAC_APP`, `OTHER`, `ROBOT`, `WINDOWS_APP`, `DESKTOP_APP`, `TV_WEB`, `TV_APP`.
- `filter.install_activity_data_country_code` (array of string)
- `filter.install_activity_data_has_app` (array of string)
- `filter.install_activity_data_has_clicked_email` (array of string)
- `filter.install_activity_data_has_clicked_ad` (array of string)
- `filter.install_activity_timezone_adjusted_day` (array of string)
- `filter.install_activity_touch_data_tilde_placement` (array of string)
- `filter.install_activity_data_device_type` (array of enum) — One of `ANDROID_PHONE`, `ANDROID_TABLET`, `DESKTOP`, `IOS_PHONE`, `IOS_TABLET`, `OTHER`, `TV_OS`, `UNKNOWN`, `WINDOWS_PHONE`, `WINDOWS_TABLET`.
- `filter.install_activity_touch_data_tilde_sub_site_name` (array of string)
- `filter.install_activity_data_brand` (array of string)
- `filter.install_activity_data_geo_country_en` (array of string)
- `filter.install_activity_data_model` (array of string)
- `filter.install_activity_data_geo_region_en` (array of string)
- `filter.install_activity_touch_data_tilde_customer_secondary_publisher` (array of string)
- `filter.install_activity_touch_data_tilde_customer_placement` (array of string)
- `filter.install_activity_touch_data_tilde_customer_sub_site_name` (array of string)
- `filter.install_activity_touch_data_tilde_customer_campaign` (array of string)
- `filter.install_activity_touch_data_tilde_customer_ad_set_name` (array of string)
- `filter.install_activity_touch_data_tilde_customer_ad_name` (array of string)
- `filter.install_activity_touch_data_tilde_customer_keyword` (array of string)
- `filter.install_activity_touch_data_tilde_agency_id` (array of string)
- `filter.install_activity_touch_data_tilde_agency` (array of string)
- `filter.customer_event_alias` (array of string)
- `filter.reengagement_activity_attributed` (array of string)
- `filter.reengagement_activity_event_name` (array of string)
- `filter.reengagement_activity_touch_type` (array of enum) — One of `CLICK`, `IMPRESSION`, `WEB_TO_APP_AUTO_REDIRECT`.
- `filter.reengagement_activity_touch_data_tilde_campaign_id` (array of string)
- `filter.reengagement_activity_touch_data_tilde_campaign` (array of string)
- `filter.reengagement_activity_touch_data_tilde_channel` (array of string)
- `filter.reengagement_activity_touch_data_tilde_feature` (array of string)
- `filter.reengagement_activity_touch_data_tilde_stage` (array of string)
- `filter.reengagement_activity_touch_data_tilde_tags` (array of string)
- `filter.reengagement_activity_touch_data_tilde_advertising_partner_name` (array of string)
- `filter.reengagement_activity_touch_data_dollar_3p` (array of string)
- `filter.reengagement_activity_touch_data_tilde_secondary_publisher` (array of string)
- `filter.reengagement_activity_touch_data_tilde_creative_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_ad_id` (array of string)
- `filter.reengagement_activity_touch_data_tilde_ad_set_id` (array of string)
- `filter.reengagement_activity_touch_data_tilde_ad_set_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_ad_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_keyword` (array of string)
- `filter.reengagement_activity_touch_data_tilde_journey_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_view_name` (array of string)
- `filter.reengagement_activity_touch_data_plus_referring_domain` (array of string)
- `filter.reengagement_activity_touch_data_plus_via_features` (array of string)
- `filter.reengagement_activity_touch_data_plus_web_format` (array of string)
- `filter.reengagement_activity_data_os` (array of string)
- `filter.reengagement_activity_data_environment` (array of string)
- `filter.reengagement_activity_data_platform` (array of string)
- `filter.reengagement_activity_data_country_code` (array of string)
- `filter.reengagement_activity_data_has_app` (array of string)
- `filter.reengagement_activity_data_has_clicked_email` (array of string)
- `filter.reengagement_activity_data_has_clicked_ad` (array of string)
- `filter.reengagement_activity_timezone_adjusted_day` (array of string)
- `filter.reengagement_activity_touch_data_tilde_placement` (array of string)
- `filter.reengagement_activity_data_device_type` (array of string)
- `filter.reengagement_activity_touch_data_tilde_sub_site_name` (array of string)
- `filter.reengagement_activity_data_brand` (array of string)
- `filter.reengagement_activity_data_geo_country_en` (array of string)
- `filter.reengagement_activity_data_model` (array of string)
- `filter.reengagement_activity_data_geo_region_en` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_secondary_publisher` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_placement` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_sub_site_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_campaign` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_ad_set_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_ad_name` (array of string)
- `filter.reengagement_activity_touch_data_tilde_customer_keyword` (array of string)
- `filter.reengagement_activity_touch_data_tilde_agency_id` (array of string)
- `filter.reengagement_activity_touch_data_tilde_agency` (array of string)
- `filter.user_data_platform` (array of string)
- `filter.user_data_environment` (array of string)
- `filter.user_data_geo_country_code` (array of string)
- `filter.user_data_os` (array of string)
- `filter.user_data_has_app` (array of string)
- `filter.user_data_standard_events_completed` (array of string)
- `filter.user_data_custom_events_completed` (array of string)
- `filter.user_data_has_clicked_ad` (array of string)
- `filter.user_data_has_clicked_email` (array of string)
- `filter.user_data_brand` (array of string)
- `filter.user_data_device_type` (array of string)
- `filter.user_data_model` (array of string)
- `format` (enum, query) — Format of the returned data: json or csv. One of `csv`, `json`.
- `granularity` (enum) — The time granularity that each band value will represent. One of `day`, `week`, `month`.
- `limit` (integer, query) — The maximum number of results to return.
- `ordered` (enum) — Order of the response based on the ordered_by value. One of `ascending`, `descending`.
- `ordered_by` (enum) — The dimension used for sorting. One of `install_activity_attributed`, `install_activity_event_name`, `install_activity_touch_type`, `install_activity_touch_data_tilde_campaign_id`, `install_activity_touch_data_tilde_campaign`, `install_activity_touch_data_tilde_channel`, `install_activity_touch_data_tilde_feature`, `install_activity_touch_data_tilde_stage`, `install_activity_touch_data_tilde_tags`, `install_activity_touch_data_tilde_advertising_partner_name`, `install_activity_touch_data_dollar_3p`, `install_activity_touch_data_tilde_secondary_publisher`, `install_activity_touch_data_tilde_creative_name`, `install_activity_touch_data_tilde_ad_id`, `install_activity_touch_data_tilde_ad_set_id`, `install_activity_touch_data_tilde_ad_set_name`, `install_activity_touch_data_tilde_ad_name`, `install_activity_touch_data_tilde_keyword`, `install_activity_touch_data_tilde_journey_name`, `install_activity_touch_data_tilde_view_name`, `install_activity_touch_data_plus_referring_domain`, `install_activity_touch_data_plus_via_features`, `install_activity_touch_data_plus_web_format`, `install_activity_data_os`, `install_activity_data_environment`, `install_activity_data_platform`, `install_activity_data_country_code`, `install_activity_data_has_app`, `install_activity_data_has_clicked_email`, `install_activity_data_has_clicked_ad`, `install_activity_timezone_adjusted_day`, `install_activity_touch_data_tilde_placement`, `install_activity_data_device_type`, `install_activity_touch_data_tilde_sub_site_name`, `install_activity_data_brand`, `install_activity_data_geo_country_en`, `install_activity_data_model`, `install_activity_data_geo_region_en`, `install_activity_touch_data_tilde_customer_secondary_publisher`, `install_activity_touch_data_tilde_customer_placement`, `install_activity_touch_data_tilde_customer_sub_site_name`, `install_activity_touch_data_tilde_customer_campaign`, `install_activity_touch_data_tilde_customer_ad_set_name`, `install_activity_touch_data_tilde_customer_ad_name`, `install_activity_touch_data_tilde_customer_keyword`, `install_activity_touch_data_tilde_agency_id`, `install_activity_touch_data_tilde_agency`, `customer_event_alias`, `reengagement_activity_attributed`, `reengagement_activity_event_name`, `reengagement_activity_touch_type`, `reengagement_activity_touch_data_tilde_campaign_id`, `reengagement_activity_touch_data_tilde_campaign`, `reengagement_activity_touch_data_tilde_channel`, `reengagement_activity_touch_data_tilde_feature`, `reengagement_activity_touch_data_tilde_stage`, `reengagement_activity_touch_data_tilde_tags`, `reengagement_activity_touch_data_tilde_advertising_partner_name`, `reengagement_activity_touch_data_dollar_3p`, `reengagement_activity_touch_data_tilde_secondary_publisher`, `reengagement_activity_touch_data_tilde_creative_name`, `reengagement_activity_touch_data_tilde_ad_id`, `reengagement_activity_touch_data_tilde_ad_set_id`, `reengagement_activity_touch_data_tilde_ad_set_name`, `reengagement_activity_touch_data_tilde_ad_name`, `reengagement_activity_touch_data_tilde_keyword`, `reengagement_activity_touch_data_tilde_journey_name`, `reengagement_activity_touch_data_tilde_view_name`, `reengagement_activity_touch_data_plus_referring_domain`, `reengagement_activity_touch_data_plus_via_features`, `reengagement_activity_touch_data_plus_web_format`, `reengagement_activity_data_os`, `reengagement_activity_data_environment`, `reengagement_activity_data_platform`, `reengagement_activity_data_country_code`, `reengagement_activity_data_has_app`, `reengagement_activity_data_has_clicked_email`, `reengagement_activity_data_has_clicked_ad`, `reengagement_activity_timezone_adjusted_day`, `reengagement_activity_touch_data_tilde_placement`, `reengagement_activity_data_device_type`, `reengagement_activity_touch_data_tilde_sub_site_name`, `reengagement_activity_data_brand`, `reengagement_activity_data_geo_country_en`, `reengagement_activity_data_model`, `reengagement_activity_data_geo_region_en`, `reengagement_activity_touch_data_tilde_customer_secondary_publisher`, `reengagement_activity_touch_data_tilde_customer_placement`, `reengagement_activity_touch_data_tilde_customer_sub_site_name`, `reengagement_activity_touch_data_tilde_customer_campaign`, `reengagement_activity_touch_data_tilde_customer_ad_set_name`, `reengagement_activity_touch_data_tilde_customer_ad_name`, `reengagement_activity_touch_data_tilde_customer_keyword`, `reengagement_activity_touch_data_tilde_agency_id`, `reengagement_activity_touch_data_tilde_agency`, `user_data_platform`, `user_data_environment`, `user_data_geo_country_code`, `user_data_os`, `user_data_has_app`, `user_data_standard_events_completed`, `user_data_custom_events_completed`, `user_data_has_clicked_ad`, `user_data_has_clicked_email`, `user_data_brand`, `user_data_device_type`, `user_data_model`, `app_id`.
- `per_user` (boolean) — If true, divide each band value by the user count.
- `unique` (boolean) — Whether or not to return unique values.

### Responses

- `200` — Status of aggregate export.
- `400` — Bad request—typically an invalid or missing credential or parameter.
- `429` — Rate limit exceeded—reduce request frequency and retry.

### Returns

Status of aggregate export. Returns `400` and `429` on failure — see the response panel for the error shape.

### Example request

```bash
curl 'https://api2.branch.io/v2/analytics?app_id=123456789012345680' \
  --request POST \
  --header 'Access-Token: <Access-Token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "start_date": "2023-05-15",
    "end_date": "2023-05-16",
    "data_source": "install_cohort",
    "measures": [
      "OPEN"
    ],
    "granularity_band_count": 7,
    "dimensions": [
      "install_activity_touch_data_tilde_campaign"
    ],
    "filter": {
      "install_activity_touch_data_tilde_campaign": [
        "A4G"
      ]
    },
    "ordered": "descending",
    "ordered_by": "install_activity_touch_data_tilde_campaign",
    "granularity": "day",
    "enable_install_recalculation": true
  }'
```

### Example responses

`200`

```json
{
  "job_id": "0000-XXxx",
  "code": 200,
  "status_url": "https://api2.branch.io/v2/analytics/a1b2c3d4",
  "error_message": "N/A"
}
```

`400`

```json
{
  "error": {
    "message": "Authentication failed.",
    "code": 400
  }
}
```

`429`

```json
{
  "error": {
    "code": 429,
    "message": "Rate limit reached."
  }
}
```
