Organization Service V4

Organization Service


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

Back to Data Types

Organizations

Organizations represent any organization that NPR might interact with in an official capacity. Organizations aren’t limited by physical location; they can be geographically distributed (or completely virtual). When determining is an entity should be considered an “Organization” or not, a good rule of thumb is to ask “Could NPR write a contract with this entity?” If the answer is yes, they’re likely an Organization (but may also be represented via other entities).

In the Organization Service, Organizations “have” Services underneath them. This is a one-to-many relationship; an Organization may have zero or more Services associated with it.

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

Organization org IDs

Each Organization in the Organization Service has an “organization ID” or “org ID”; however, this is NOT the same as the “org ID” used for Legacy Organizations. While it is often the same as a counterpart legacy organization’s org ID, this is not an assumption developers should rely on, as it doesn’t hold in every case. In addition, while many Organization org IDs being with o, this is not a requirement for Organization org IDs; many are simply numbers.

When using an Organization’s org ID, it is best to treat it independently; it should not be viewed in the context of other IDs and meaning should not be parsed from the ID itself.