List all coupons

get

https://developers.teachable.com/v2/products/coupons

🚧 Beta: This endpoint may not be available yet and may change without notice.
Contact support to request access.

Retrieve a list of coupons for the school. Excludes single-use and student-referral coupons. Without product context, returns only school-wide (non-product-specific) coupons.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

is_published

boolean

pricing_plan_id

integer

Filter by pricing plan ID. Meaningful on schools not using the new payments experience; on schools using the new payments experience, matches only coupons scoped by pricing plan (typically empty).

product_type

string

enum

Filter by product. On schools using the new payments experience, resolves via the product itself; otherwise resolves via the pricing plans attached to it. Must be paired with product_id.

product_id

integer

ID of the entity identified by product_type; required when product_type is present.

created_after

string

ISO8601 datetime; invalid values return 400. Date range between created_after and created_before cannot exceed 90 days.

created_before

string

ISO8601 datetime; invalid values return 400. Date range between created_after and created_before cannot exceed 90 days.

page

integer

≥ 1

per_page

integer

1 to 100

sort_by

string

Sort by field (created_at, updated_at)

sort_direction

string

Sort direction (asc, desc)

Headers

apiKey

string

required

Generated Admin API key

Responses

200Successful

400Invalid request