> For the complete documentation index, see [llms.txt](https://docs.getuntitled.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getuntitled.ai/api-documentation/audiences.md).

# Audiences

## List Audiences

> Returns all your saved audiences.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_AudienceApiResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AudienceApiResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[AudienceApiResponse]"},"AudienceApiResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Members Count"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"lookback_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Window"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"last_synced":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","created_at","updated_at"],"title":"AudienceApiResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences":{"get":{"tags":["Audiences"],"summary":"List Audiences","description":"Returns all your saved audiences.","operationId":"get_audiences_audiences_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_AudienceApiResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Create Audience

> Creates a new audience from the provided filters. Building happens asynchronously in the background — the audience will have \`status: queued\` until the build completes.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceCreateRequest":{"properties":{"name":{"type":"string","title":"Name","description":"A name for this audience."},"filters":{"$ref":"#/components/schemas/ApiFilters","description":"Defines who belongs to this audience. Supports filtering on visitors, sessions, pages, buyer intent, enrichment data, and ML scores."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"lookback_window":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Lookback Window","description":"How many days of session history to include when building the audience.","default":60},"refresh_cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Cron","default":"55 15 * * *"}},"type":"object","required":["name","filters"],"title":"AudienceCreateRequest"},"ApiFilters":{"properties":{"visitors":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Visitors"},"sessions":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Sessions"},"pages":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Pages"},"buyer_intent":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Buyer Intent"},"enrichment":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Enrichment","description":"Nested by enrichment source, e.g. {\"klaviyo\": [...], \"shopify\": [...]}."},"ml":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Ml","description":"Nested by ML model name, e.g. {\"icp\": [...]}."}},"additionalProperties":false,"type":"object","title":"ApiFilters","description":"Top-level filter payload, grouped by entity.\n\nAll lists default to empty so callers only need to populate the entities\nthey actually filter on."},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"AudienceApiResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Members Count"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"lookback_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Window"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"last_synced":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","created_at","updated_at"],"title":"AudienceApiResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences":{"post":{"tags":["Audiences"],"summary":"Create Audience","description":"Creates a new audience from the provided filters. Building happens asynchronously in the background — the audience will have `status: queued` until the build completes.","operationId":"create_audience_audiences_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Audience

> Returns a single audience by ID, including its filters and current build status.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceApiResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Members Count"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"lookback_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Window"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"last_synced":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","created_at","updated_at"],"title":"AudienceApiResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}":{"get":{"tags":["Audiences"],"summary":"Get Audience","description":"Returns a single audience by ID, including its filters and current build status.","operationId":"get_audience_by_id_audiences__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Delete Audience

> Deletes an audience and all its members.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceApiDeleteResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","name","message"],"title":"AudienceApiDeleteResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}":{"delete":{"tags":["Audiences"],"summary":"Delete Audience","description":"Deletes an audience and all its members.","operationId":"delete_audience_audiences__id__delete","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Refresh Audience

> Triggers a rebuild of the audience. Returns \`400\` if the audience is already syncing.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"AudienceApiRefreshResponse":{"properties":{"audience_id":{"type":"string","title":"Audience Id"},"name":{"type":"string","title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["audience_id","name"],"title":"AudienceApiRefreshResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}/refresh":{"post":{"tags":["Audiences"],"summary":"Refresh Audience","description":"Triggers a rebuild of the audience. Returns `400` if the audience is already syncing.","operationId":"refresh_audience_audiences__id__refresh_post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceApiRefreshResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## List Audience Members

> Returns the visitor profiles that belong to this audience.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_AudienceApiMemberResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AudienceApiMemberResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[AudienceApiMemberResponse]"},"AudienceApiMemberResponse":{"properties":{"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"personal_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal City"},"married":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Married"},"company_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Phone"},"company_sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Sic"},"company_employee_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Employee Count"},"un_processed_timestamp":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Un Processed Timestamp"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"personal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal State"},"income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Income Range"},"professional_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address2"},"company_naics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Naics"},"primary_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Industry"},"un_updated_timestamp":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Un Updated Timestamp"},"business_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email"},"personal_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip"},"net_worth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Net Worth"},"professional_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional City"},"company_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Address"},"business_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email Validation Status"},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobile Phone"},"personal_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip4"},"homeowner":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Homeowner"},"professional_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional State"},"company_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company City"},"business_email_last_seen":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Business Email Last Seen"},"hem":{"type":"string","title":"Hem"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"personal_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"professional_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip"},"company_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company State"},"personal_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email Validation Status"},"record_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Uuid"},"personal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address"},"personal_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Phone"},"seniority_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"professional_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip4"},"company_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Zip"},"personal_email_last_seen":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Personal Email Last Seen"},"personal_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address2"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"},"age_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Range"},"professional_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_revenue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Revenue"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"last_session_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Session Date"},"last_session_exit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Exit Url"},"last_session_entry_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Entry Url"},"last_session_entry_referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Entry Referer Url"},"total_session_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Session Count"},"last_session_est_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Session Est Duration"},"last_session_total_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Session Total Pages Visited"},"lead_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Category"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"}},"type":"object","required":["hem"],"title":"AudienceApiMemberResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/audiences/{id}/members":{"get":{"tags":["Audiences"],"summary":"List Audience Members","description":"Returns the visitor profiles that belong to this audience.","operationId":"get_audience_members_audiences__id__members_get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_AudienceApiMemberResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.getuntitled.ai/api-documentation/audiences.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.