/channel/subscribers

Returns a channel's subscribers based on input parameters.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

📘

This endpoint is paginated

Make sure to review how our Cursors work to get the most out of this call.

📘

This endpoint Accepts Include Parameters

Be sure to review how include parameters work if you haven't yet.

Include Parameters

Include ParameterDescription
userReturns a user object nested with each subscriber object
tierReturns a tier object nested within each subscriber object.
user,tierReturns both the tier and user object nested within each subscriber object.
Query Params
string
required

The OAuth2 Access Token of the channel.

string
required
Defaults to read_only

the read_only scope is required, and supplied by default.

string
Defaults to null

Allows optional information inclusion with this query. See "Documentation" section below.

int32
Defaults to 10

Limit on the number of subscribers returned. Min: 1, max: 50

string
Defaults to desc

Ordering of the created_at date on the returned subscribers. Options: asc, desc

string
Defaults to all

Filter the returned subscribers by status. Options: all, active, inactive, trial, twitch, grace_period, billing_grace_period. Options can be comma separated to return records that match any of the given status fields in the query

string
Defaults to null

Used for pagination. See Response Pagination.

string
Defaults to nill

Used for pagination. See Response Pagination.

Response

Language
Credentials
Query
LoadingLoading…
Response
Choose an example:
application/json