> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Audiences

> Lists the custom audiences (uploaded CSV customer lists) for an account.



## OpenAPI

````yaml /openapi/api-v1-native.yml get /audiences
openapi: 3.1.0
info:
  title: Whop API
  description: >-
    Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema
    at build time.
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.whop.com/api/v1
security: []
paths:
  /audiences:
    get:
      tags:
        - Audiences
      summary: List Audiences
      description: Lists the custom audiences (uploaded CSV customer lists) for an account.
      operationId: listAudiences
      parameters:
        - name: account_id
          in: query
          schema:
            type: string
          required: true
          description: >-
            The ID of the account that owns the audiences, which will look like
            biz_*************.
        - name: audience_id
          in: query
          schema:
            type: string
          required: false
          description: >-
            Optional audience ID to filter the response to one audience, which
            will look like adaud_*************.
        - name: first
          in: query
          schema:
            type: integer
          required: false
          description: The number of audiences to return (default 20, max 100).
        - name: after
          in: query
          schema:
            type: string
          required: false
          description: A cursor; returns audiences after this position.
      responses:
        '200':
          description: audiences listed
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Audience'
                  page_info:
                    type: object
                    properties:
                      end_cursor:
                        type:
                          - string
                          - 'null'
                      start_cursor:
                        type:
                          - string
                          - 'null'
                      has_next_page:
                        type: boolean
                      has_previous_page:
                        type: boolean
                    required:
                      - end_cursor
                      - start_cursor
                      - has_next_page
                      - has_previous_page
                required:
                  - data
                  - page_info
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: missing or invalid authentication
      security:
        - bearerAuth:
            - audience:basic:read
components:
  schemas:
    Audience:
      type: object
      properties:
        id:
          type: string
          description: The ID of the audience, which will look like adaud_*************
        name:
          type: string
          description: The display name of the audience
        status:
          type: string
          description: >-
            Processing status: pending, processing, syncing, ready, partial, or
            failed
        total_rows:
          type: number
          description: Total data rows detected in the uploaded CSV
        processed_rows:
          type: number
          description: Rows ingested so far
        matched_rows:
          type: number
          description: Rows uploaded to the ad platform
        progress_percent:
          type: number
          description: Processing progress from 0 to 100
        error_message:
          type:
            - string
            - 'null'
          description: Populated when the audience is partial or failed
        platform_audience_ids:
          type: array
          description: External ad-platform audience IDs created for this audience
        created_at:
          type: number
          description: When the audience was created, as a Unix timestamp
        updated_at:
          type: number
          description: When the audience was last updated, as a Unix timestamp
      required:
        - id
        - name
        - status
        - total_rows
        - processed_rows
        - matched_rows
        - progress_percent
        - error_message
        - platform_audience_ids
        - created_at
        - updated_at
    V1ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Human-readable error message.
          required:
            - type
            - message
      required:
        - error
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        An account API key, account scoped JWT, app API key, or user OAuth
        token.

````