List LINE Audiences
line_list_audiencesRetrieve audience groups from your LINE Official Account, filtered by status or name, to select audiences for broadcast messages.
Instructions
List audience groups on the OA. Audiences created via LINE OA Manager UI (e.g. chat-tag audiences, friend-path audiences, web-traffic audiences) also appear here — even though those types cannot be CREATED via Messaging API.
Status meanings:
READY: usable in narrowcast immediately
IN_PROGRESS: still indexing — wait ~10 minutes
FAILED: creation failed; recreate
EXPIRED: aged out; recreate
Args:
status_filter: 'all' (default) | 'READY' | 'IN_PROGRESS' | 'FAILED' | 'EXPIRED'.
name_contains: optional substring filter (case-insensitive).
limit, page: pagination (default 20/page).
oa: optional OA id.
Returns: { total: number, count: number, page: number, audiences: [{ audience_group_id, name, status, audience_count?, created, type? }], has_more: boolean }
Examples:
"ดู audience ที่พร้อมส่ง" → { status_filter: "READY" }
"หา audience ชื่อ vip" → { name_contains: "vip" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status_filter | No | Filter audiences by readiness status. Default 'all'. | all |
| name_contains | No | Optional substring filter on audience name (case-insensitive). | |
| limit | No | Page size (max 100). | |
| page | No | Page number (1-indexed). | |
| oa | No | ||
| response_format | No | markdown |