Skip to main content
GET
/
stripe
/
connect
/
accounts
/
{accountId}
/
coupons
/
{couponId}
/
promotion-codes
List Promotion Codes by Coupon
curl --request GET \
  --url https://api.chat-dash.com/v1/public/stripe/connect/accounts/{accountId}/coupons/{couponId}/promotion-codes \
  --header 'Authorization: <authorization>'
{
  "data": [
    {
      "id": "promo_1SucFwRjNw7C4HMK01fsfjOh",
      "object": "promotion_code",
      "active": true,
      "code": "SUMMER20",
      "coupon": {
        "id": "rgJkxQB4",
        "object": "coupon",
        "amount_off": null,
        "created": 1751915454,
        "currency": "usd",
        "duration": "repeating",
        "duration_in_months": 3,
        "livemode": true,
        "max_redemptions": null,
        "metadata": {},
        "name": "3Months Off",
        "percent_off": 10,
        "redeem_by": null,
        "times_redeemed": 6,
        "valid": true
      },
      "created": 1769620216,
      "customer": "cus_TppcYxuTJKLNnG",
      "customer_account": null,
      "expires_at": 1770137940,
      "livemode": true,
      "max_redemptions": 10,
      "metadata": {},
      "restrictions": {
        "first_time_transaction": true,
        "minimum_amount": null,
        "minimum_amount_currency": null
      },
      "times_redeemed": 0
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Headers

Authorization
string
required

All requests to the ChatDash API must be validated with the agency API Key found on your agency profile

Path Parameters

accountId
string
required

The Stripe connected account ID

couponId
string
required

The Stripe coupon ID

Query Parameters

limit
integer
default:50

Max number of promotion codes to return (1-100). Defaults to 50.

Required range: 1 <= x <= 100
starting_after
string

Pagination cursor (returns results after this ID).

Response

OK

data
object[]
has_more
boolean

Whether there are more results available

Example:

false

next_cursor
string | null

Cursor for the next page of results

Example:

null