v1

latestSwagger 2.02026-07-1422425.0 KB
stationfinder

Retrieve metadata for the station with the given numeric ID

This endpoint retrieves information about a given station, based on its numeric ID, which is consistent across all of NPR's APIs.

A typical use case for this data is for clients who want to create a dropdown menu, modal/pop-up or dedicated page displaying more information about the station the client is localized to, including, for example, links to the station's homepage and donation (pledge) page.

get/v3/stations/{stationId}

Path parameters

stationIdinteger required

The numeric ID of a station

Headers

Authorizationstring required

Your access token from the Authorization Service. Should start with Bearer, followed by a space, followed by the token.

Response

A document describing the station with the given ID

errorsobject[] required

A list of encountered errors, ignored on POST, PUT

hrefstring required

A URL representation of the resource; should generally be ignored by clients unless noted otherwise

itemsobject[] required

Not used

versionstring required

The version of the Collection.Doc+JSON spec being used