Get LINE coupon redemption stats
line_get_coupon_statsGet coupon stats by combining raw coupon details and optional click audience data to estimate redemptions. Includes notes on data source limitations.
Instructions
Read available stats for a LINE coupon. We combine multiple signals because LINE's Coupon API does not (yet) expose a dedicated redemption-events endpoint:
Raw coupon detail (LINE GET /v2/bot/coupon/{id}) — some accounts include usage fields inline.
Click-audience size (if you pass click_audience_id) — proxies "users who clicked through".
Args:
coupon_id: ID of the coupon (from line_manage_coupon mode='list' or mode='create').
click_audience_id: optional numeric audience id to enrich the report.
oa: optional OA id.
response_format: 'markdown' (default) | 'json'.
Returns (structured): { coupon_id, raw: {...whatever LINE returned about the coupon...}, click_audience?: { id, name, audience_count, status }, estimated_redemptions?: number, notes: string[] // explains data sources clearly }
Notes:
For an accurate redemption count, build your coupon Flex with a postback action and listen for postback events via a webhook server (V2 webhook-server companion).
Click audience size approximates "clickthroughs", not actual redemptions — surface this caveat to the user.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coupon_id | Yes | ||
| click_audience_id | No | Optional — if you created a click audience from the coupon broadcast, pass its id to enrich the stats with click-through count. | |
| oa | No | ||
| response_format | No | markdown |