---
title: "Changes to List custom audiences"
method: GET
path: "/v1/ads/audiences"
---

# Changes to List custom audiences

`GET /v1/ads/audiences`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 56 revisions.

- **2026-09-25** `2c04683ce694` — 6 breaking, 4 warning, 12 info
- **2026-09-16** `3e6ddf2a99ea` — 3 info
- **2026-09-15** `0dba7d004d75` — 6 info
- **2026-09-14** `a23eb241746a` — 2 info
- **2026-09-10** `e70ed06e7150` — 3 info
- **2026-09-09** `222e3a38a382` — 2 info
- **2026-09-02** `017dff7e4324` — 3 info

## Changes

- **2026-09-25** `2c04683ce694` — 6 breaking, 4 warning, 12 info
  - added `subschema #1, subschema #2` to the `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/cities/items/` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/regions/items/` response property `oneOf` list for the response status `200`
  - the `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/cities/items/` response's property type changed from `object` to no type for status `200`
  - the `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/regions/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/cities/items/key` from the response with the `200` status
  - removed the required property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/regions/items/key` from the response with the `200` status
  - removed the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/cities/items/distanceUnit` from the response with the `200` status
  - removed the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/cities/items/name` from the response with the `200` status
  - removed the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/cities/items/radius` from the response with the `200` status
  - removed the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/regions/items/name` from the response with the `200` status
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/adAccountId` to the response with the `404` status
  - added the optional property `details/adAccountId` to the response with the `409` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `404` status
  - added the optional property `details/createdObjects` to the response with the `409` status
  - added the optional property `details/stage` to the response with the `400` status
  - added the optional property `details/stage` to the response with the `404` status
  - added the optional property `details/stage` to the response with the `409` status
  - added the optional property `details/unconfirmedWrite` to the response with the `400` status
  - added the optional property `details/unconfirmedWrite` to the response with the `404` status
  - added the optional property `details/unconfirmedWrite` to the response with the `409` status
- **2026-09-16** `3e6ddf2a99ea` — 3 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `404` status
  - added the optional property `details/budgetScope` to the response with the `409` status
- **2026-09-15** `0dba7d004d75` — 6 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `404` status
  - added the optional property `details/quotaExhausted` to the response with the `409` status
  - added the optional property `details/quotaScope` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `404` status
  - added the optional property `details/quotaScope` to the response with the `409` status
- **2026-09-14** `a23eb241746a` — 2 info
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/countryGroups` to the response with the `200` status
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/excludedLocations/countryGroups` to the response with the `200` status
- **2026-09-10** `e70ed06e7150` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
- **2026-09-09** `222e3a38a382` — 2 info
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/userDevice` to the response with the `200` status
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/userOs` to the response with the `200` status
- **2026-09-02** `017dff7e4324` — 3 info
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/workEmployers` to the response with the `200` status
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/workIndustries` to the response with the `200` status
  - added the optional property `audiences/items/spec/anyOf[#/components/schemas/TargetingSpec]/workPositions` to the response with the `200` status

---

[Operation](https://skmtc.dev/zernio/apis/zernio-api/docs/v1/ads/audiences/get.md) · [API](https://skmtc.dev/zernio/apis/zernio-api.md) · [Page](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/audiences/get)
