Organization Service V4

Organization Service


Project maintained by npr Hosted on GitHub Pages — Theme by mattgraham

Back to Data Types

Legacy Organizations

A Legacy Organization is any organization that contains a representation in the “legacy” organizations table in the API database. This category includes the following:

Legacy Organizations will always have one and only one Service affiliated with them; this affiliation represents the Service responsible for “serving” the content produced by this Station.

Legacy Organization data is available via the /v4/legacy/organizations/<org ID> endpoint.

Stations and Legacy Organizations

In the context of the Organization Service, all Stations are Legacy Organizations, but not all Legacy Organizations are Stations. When a Station’s data is updated in the Organization Service via the nightly syncronization (or the /v4/stations/<org ID> endpoint), the Organization Service updates the data in the /v4/stations/<org ID> endpoint and the /v4/legacy/organizations/<org ID> endpoint.

Non-Stations and Legacy Organizations

Any Legacy Organization that is not also represented by a Station in the Organization Service is a non-station (sometimes these are called “third parties” for convenience, but that’s not necessarily an accurate term; some of these may not be strictly third parties from NPR’s perspective). Non-station data is maintained in the Organization Service manually; someone (usually Member Partnerships or Online Tech) will request that a new entry be created for a Legacy Organization, and that it be assigned an existing Service. When this occurs, the entry is created or maintained via the the /v4/legacy/organizations endpoint.