Retrieve a channel
Read one channel back from the allowlist by its id, in the same shape List channels returns.
GET/api/v4/allowlist/channels/{id}/
Path parameters
| Parameter | Description |
|---|---|
id | The id from the channel object — Slipstream’s identifier for the allowlist entry, not the YouTube channel id. |
Headers
| Header | Required | Description |
|---|---|---|
X-User-ID | No | Required if the channel belongs to one of your end users rather than your own account. Without it the channel is not found. |
Example request
curl https://api.slipstreammusic.com/api/v4/allowlist/channels/9b5c3d2e-0a8e-4b7c-8c4d-2f9e5f6b8d7c/ \
-H "Authorization: Bearer $PARTNER_API_KEY"Example response
{
"id": "9b5c3d2e-0a8e-4b7c-8c4d-2f9e5f6b8d7c",
"channel_id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"name": "Google for Developers",
"provider": "youtube",
"image_url": "https://yt3.ggpht.com/..."
}See the channel object for the fields.
Errors
| HTTP | When |
|---|---|
| 401 | No credential, or the credential is not recognised |
| 403 | Channel management is not enabled on your account, or X-User-ID was sent from an account without end-user support |
| 404 | No channel with that id on this allowlist — it was never there, it was removed, it belongs to another account, or it belongs to an end user you did not name with X-User-ID. Also when X-User-ID names an end user we have no record of |
| 406 | These endpoints only produce JSON. Send Accept: application/json or */* |
| 429 | Rate limit or usage allowance exceeded |