---
title: "Changes to Audience Readout"
method: GET
path: "/v2/campaigns/{id}/audiences/{audience_id}/readout"
---

# Changes to Audience Readout

`GET /v2/campaigns/{id}/audiences/{audience_id}/readout`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 14 revisions.

- **2026-09-30** `bfb85c07a3d3` — 1 info
- **2026-09-17** `17f24eb0ac1a` — 2 info
- **2026-09-09** `217c96dc9a29` — 36 breaking, 138 info

## Changes

- **2026-09-30** `bfb85c07a3d3` — 1 info
  - added the optional property `revalidating` to the response with the `200` status
- **2026-09-17** `17f24eb0ac1a` — 2 info
  - added the optional property `rows/items/trial_billing_issue` to the response with the `200` status
  - added the optional property `rows/items/trial_billing_issue_rate` to the response with the `200` status
- **2026-09-09** `217c96dc9a29` — 36 breaking, 138 info
  - removed the enum value `PRODUCTION` from the `query` request parameter `environment`
  - removed the enum value `SANDBOX` from the `query` request parameter `environment`
  - removed the enum value `false` from the `query` request parameter `refresh`
  - removed the enum value `placement` from the `query` request parameter `breakdown`
  - removed the enum value `true` from the `query` request parameter `refresh`
  - removed the enum value `variantId` from the `query` request parameter `breakdown`
  - the `rows/items/direct_sub_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/non_renewing_purchase_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/proj_pending_trial_conversion_proceeds/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/proj_pending_trial_conversions/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/proj_proceeds/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/proj_proceeds_per_user/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/resubscribe_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/subscription_cancellation_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/transaction_complete_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/trial_cancellation_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/trial_conversion_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `rows/items/trial_start_rate/anyOf[subschema #1]/` response property's minItems was decreased from `3` to `0` for the response status `200`
  - the `code` response's property type changed from `string` to no type for status `403`
  - the `code` response's property type changed from `string` to no type for status `404`
  - the `code` response's property type changed from `string` to no type for status `429`
  - the `code` response's property type changed from `string` to no type for status `500`
  - the `doc_url` response's property type changed from `string` to no type for status `403`
  - the `doc_url` response's property type changed from `string` to no type for status `404`
  - the `message` response's property type changed from `string` to no type for status `404`
  - the `message` response's property type changed from `string` to no type for status `429`
  - the `message` response's property type changed from `string` to no type for status `500`
  - the `param` response's property type changed from `string` to no type for status `404`
  - the `required_scope` response's property type changed from `string` to no type for status `403`
  - the `resource_id` response's property type changed from `string` to no type for status `404`
  - the `resource_type` response's property type changed from `string` to no type for status `404`
  - the `retry_after` response's property type changed from `number` to no type for status `429`
  - the `type` response's property type changed from `string` to no type for status `403`
  - the `type` response's property type changed from `string` to no type for status `404`
  - the `type` response's property type changed from `string` to no type for status `429`
  - the `type` response's property type changed from `string` to no type for status `500`
  - for the `query` request parameter `breakdown`, the type was generalized from `string` to no type
  - for the `query` request parameter `environment`, the type was generalized from `string` to no type
  - for the `query` request parameter `refresh`, the type was generalized from `string` to no type
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the response body `anyOf` list for the response status `401`
  - …134 more
  - …this revision’s changelog is incomplete

---

[Operation](https://skmtc.dev/superwall/apis/superwall-api-v2/docs/v2/campaigns/:id/audiences/:audience_id/readout/get.md) · [API](https://skmtc.dev/superwall/apis/superwall-api-v2.md) · [Page](https://skmtc.dev/superwall/apis/superwall-api-v2/changes/v2/campaigns/:id/audiences/:audience_id/readout/get)