List your audiences
Your saved address lists, used as the targeting for ADM campaigns.
Filter by ids or statuses, search on name, and page with first (up to 500) and skip.
address_count is how many addresses the list holds — the figure the cost preview bills on. A null means we could not read it, which is not the same as zero.
An audience must be READY before a campaign using it can be submitted.
Authorization
ClientBearer Client-scoped key as a Bearer JWT; always pinned to your own client.
In: header
Query Parameters
Page size 1..500 (default 50).
Page offset (default 0).
Response Body
application/json
curl -X GET "https://example.com/client/audiences"{ "success": true, "data": { "nodes": [ { "id": "331", "name": "Spring buyers", "client_id": "450", "status": "READY", "address_count": 4820 } ], "totalCount": 1 }}Price a draft before submitting GET
What a draft would cost if you submitted it as it stands: quantity, price per piece, subtotal, tax and total — the same running estimate the Oppizi builder shows. Read-only: it prices the draft without changing it.
List your designs GET
Your own flyer and mail-piece designs. Filter by format or status, search by name, and sort. `name` is the file name the design was uploaded under, and that is what `search` matches. Use a design's `id` with [Choose the creative](/docs/api-reference/campaign-builder/selectcampaigndesign).