intended_use | enum (inclusion, exclusion, bid_multiplier) | No | - | Return audiences eligible for this use. Ready does not imply eligible. Inclusion/bid adjustments have matched-size requirements; ready empty audiences may be eligible for exclusion. |
policy_revision | string | No | - | Optional policy token obtained separately from the OpenAI Ads API. Omit to use current eligibility rules; on revision mismatch, retry without it and review the selection. |
matched_count_granularity | enum (granular) | No | - | Use granular for finer privacy-preserving matched-count ranges, not exact counts. |
filters | array of FilterItem | No | - | AND filters on id, name, status, description, or membership_revision. Applied before limit; raw audience objects are preserved. |
order | enum (asc, desc) | No | - | Creation order, asc or desc. Defaults to desc. |
limit | integer | No | 100 | Maximum matching audiences. Default 100; scans at most 5,000 records. Results may be limited; narrow the filters when needed. |