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

# List custom audiences

Returns paginated custom audiences created for the store. Does not include built-in default audiences (channel, referer, country).

```json
{"openapi":"3.1.1","info":{"title":"Shoplift Public API","version":"1.0.0"},"tags":[{"name":"Public API"}],"servers":[{"url":"https://app.shoplift.ai"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","description":"All requests require `Authorization: Bearer sl_live_<your_api_key>`. Generate a key from the Shoplift admin's API Keys settings page.","scheme":"bearer"}},"schemas":{"ExternalAudienceListResponse":{"required":["customAudiences","pagination"],"type":"object","properties":{"customAudiences":{"type":"array","items":{"$ref":"#/components/schemas/ExternalAudienceItem"}},"pagination":{"$ref":"#/components/schemas/ExternalPaginationMeta"}}},"ExternalAudienceItem":{"required":["id","name","rules"],"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/ExternalAudienceRuleItem"}}}},"ExternalAudienceRuleItem":{"required":["dimension","operator","values"],"type":"object","properties":{"dimension":{"type":"string"},"operator":{"type":"string"},"values":{"type":"array","items":{"type":"string"}},"selector":{"type":["null","string"]}}},"ExternalPaginationMeta":{"required":["page","perPage","totalPages","totalCount"],"type":"object","properties":{"page":{"type":"integer","format":"int32"},"perPage":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"},"totalCount":{"type":"integer","format":"int32"}}},"ProblemDetails":{"type":"object","properties":{"type":{"type":["null","string"]},"title":{"type":["null","string"]},"status":{"type":["null","integer"],"format":"int32"},"detail":{"type":["null","string"]},"instance":{"type":["null","string"]}}}}},"paths":{"/api/public/v1/custom-audiences":{"get":{"tags":["Public API"],"summary":"List custom audiences","description":"Returns paginated custom audiences created for the store. Does not include built-in default audiences (channel, referer, country).","operationId":"listCustomAudiences","parameters":[{"name":"page","in":"query","schema":{"type":"integer","format":"int32"}},{"name":"perPage","in":"query","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAudienceListResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}}}
```