Skip to main content
GET
/
stripe
/
connect
/
accounts
/
{accountId}
/
subscriptions
List Subscriptions
curl --request GET \
  --url https://api.chat-dash.com/v1/public/stripe/connect/accounts/{accountId}/subscriptions \
  --header 'Authorization: <authorization>'
{
  "subscriptions": [
    {
      "id": "sub_1ABC123DEF456GHI",
      "type": "subscription",
      "status": "active",
      "cancelAtPeriodEndDisplay": null,
      "customer": {
        "id": "cus_ABC123XYZ",
        "email": "customer@example.com"
      },
      "current_period_start": 1700000000,
      "current_period_end": 1702600000,
      "created": 1700000000,
      "collection_method": "charge_automatically",
      "cancel_at_period_end": false,
      "canceled_at": null,
      "product": {
        "id": "prod_ABC123XYZ",
        "name": "Pro Plan"
      },
      "automatic_tax": false,
      "coupon": "",
      "agents": "Agent 1, Agent 2"
    }
  ],
  "has_more": true,
  "next_cursor": "sub_2DEF456GHI789JKL"
}

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

Query Parameters

​
status
enum<string>
default:active

Filter subscriptions by status. Defaults to active.

Available options:
scheduled,
trialing,
active,
incomplete,
incomplete_expired,
past_due,
canceled,
unpaid,
paused
​
limit
integer
default:100

Max number of subscriptions to return (1-100). Defaults to 100.

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

Pagination cursor (returns results after this ID).

Response

OK

​
subscriptions
object[]
​
has_more
boolean
Example:

true

​
next_cursor
string | null
Example:

"sub_2DEF456GHI789JKL"