Search + K

Command Palette

Search for a command to run...

Sign In

Get Show

GET /shows/{id}
Copy endpoint
https://api.spotify.com/v1

Get Spotify catalog information for a single show identified by its unique Spotify ID.

Parameters

path Path Parameters

Name Type
id required
string

query Query Parameters

Name Type
market
string

Responses

200 application/json

A show

type ShowObject = interface ShowBase {
available_markets: string[];
copyrights: CopyrightObject
interface CopyrightObject {
text?: string;
type?: string;
}
[]
;
description: string;
html_description: string;
explicit: boolean;
external_urls: ExternalUrlObject
interface ExternalUrlObject {
spotify?: string;
}
;
href: string;
id: string;
images: ImageObject
interface ImageObject {
url: string;
height: number | null;
width: number | null;
}
[]
;
is_externally_hosted: boolean;
languages: string[];
media_type: string;
name: string;
publisher: string;
type: "show";
uri: string;
total_episodes: number;
}
& { episodes: {} & PagingSimplifiedEpisodeObject
type PagingSimplifiedEpisodeObject = never
; }

Client Errors

401 application/json

Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
403 application/json

Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
429 application/json

The app has exceeded its rate limits.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }