> ## Documentation Index > Fetch the complete documentation index at: https://developers.usewave.co/llms.txt > Use this file to discover all available pages before exploring further. # List Audiences > Retrieve all audience lists in your workspace, including live scraping progress and applied filter criteria. ## OpenAPI ````yaml GET /api/v1/audiences openapi: 3.1.0 info: title: Wave Public API description: >- ### Authentication All public endpoints require a valid API Key provided via header: * **Authorization:** `Bearer wave_live_...` ### Access Control API access is tied directly to your Wave subscription. An active or trialing subscription is required. Inactive subscriptions will receive a `403 Forbidden` error. ### Rate Limiting Requests are limited per API key using a 60-second sliding window. Tiers: **Paid** Subscription get 60 requests/min, **Trial** Subscription get 30 requests/min. Every authenticated response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. Exceeding the limit returns `429 Too Many Requests` with a `Retry-After` header indicating the seconds to wait. license: name: Proprietary url: https://app.usewave.co/ version: 1.0.0 servers: [] security: [] paths: /api/v1/audiences: get: tags: - Audiences summary: List Audiences description: >- Retrieves all audience lists created by the authenticated user/agency with lead counts and filter rules. operationId: list_audience_lists responses: '200': description: Successful Response content: application/json: schema: items: $ref: '#/components/schemas/PublicAudienceSummaryResponse' type: array title: Response List Audience Lists '400': description: Bad Request - Invalid parameters or input payload content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '401': description: Unauthorized - Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '403': description: Forbidden - Active subscription required content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '404': description: >- Not Found - The resource does not exist or belongs to another account content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '422': description: Unprocessable Entity - Schema validation failed content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '429': description: Rate Limit Exceeded - Request quota exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '500': description: Internal Server Error - Unexpected server error content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' security: - HTTPBearer: [] components: schemas: PublicAudienceSummaryResponse: properties: id: type: string format: uuid title: Id description: Unique audience list UUID name: type: string title: Name description: Audience name desc: anyOf: - type: string - type: 'null' title: Desc description: Audience description type: type: string title: Type description: Audience source type (e.g. FOLLOWERS, MANUAL) max_scrape_count: anyOf: - type: integer - type: 'null' title: Max Scrape Count description: Configured maximum scrape target raw_audience: type: integer title: Raw Audience description: Total raw leads extracted from Instagram default: 0 filtered_audience: type: integer title: Filtered Audience description: Total leads that passed the filter criteria default: 0 filters: items: $ref: '#/components/schemas/FilterConfigSchema' type: array title: Filters description: Applied filters default: [] created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At type: object required: - id - name - type title: PublicAudienceSummaryResponse description: Summary overview of an audience list with live metrics. ErrorMessageResponse: properties: status: type: integer title: Status description: HTTP status code example: 400 error: type: string title: Error description: HTTP status phrase or category example: Bad Request message: type: string title: Message description: Human-readable explanation of the error example: Invalid request parameters. details: anyOf: - {} - type: 'null' title: Details description: Granular validation failure details or contextual information type: object required: - status - error - message title: ErrorMessageResponse description: Standardized public error response structure modeled after Dripify. FilterConfigSchema: properties: type: $ref: '#/components/schemas/ListFiltersType' description: >- Filter type: FOLLOWERS_COUNT, POST_COUNT, HAS_PROFILE_PICTURE, IS_VERIFIED, IS_PUBLIC, ACCOUNT_TYPE, HAS_KEYWORDS example: FOLLOWERS_COUNT min_value: anyOf: - type: integer - type: 'null' title: Min Value description: Minimum numeric threshold example: 500 max_value: anyOf: - type: integer - type: 'null' title: Max Value description: Maximum numeric threshold example: 50000 bool_value: anyOf: - type: boolean - type: 'null' title: Bool Value description: Boolean match (e.g. for HAS_PROFILE_PICTURE, IS_VERIFIED, IS_PUBLIC) example: true account_type: anyOf: - type: string - type: 'null' title: Account Type description: Account type (e.g. 'Business' or 'Personal') include: anyOf: - items: type: string type: array - type: 'null' title: Include description: Keywords that must be present in user bio default: [] exclude: anyOf: - items: type: string type: array - type: 'null' title: Exclude description: Keywords that must NOT be present in user bio default: [] type: object required: - type title: FilterConfigSchema description: Filter rule to filter scraped leads. ListFiltersType: type: string enum: - FOLLOWERS_COUNT - POST_COUNT - HAS_PROFILE_PICTURE - IS_VERIFIED - IS_PUBLIC - ACCOUNT_TYPE - HAS_KEYWORDS title: ListFiltersType securitySchemes: HTTPBearer: type: http description: 'Enter your API key: `wave_live_`' scheme: bearer ````