GET organization/…/license

GET Retrieves the license details for content published by an organization.

Resource URL

https://www.drillster.com/api/2/organization/{organization_id}/license

or

https://www.drillster.com/api/2/organization/self/license

Parameters

Field Type Description
organization_id
optional
String

The organization ID to retrieve the license details for. May be replaced with self to refer to the own organization.

Example value: nPjYUn0upc8dIm7yzTIBgQ

Response

A 2.0 License object with the details of the publication license.

Example request

GET https://www.drillster.com/api/2/organization/nPjYUn0upc8dIm7yzTIBgQ/license

Response

{
  "type" : "CLOSED",
  "text" : "Copyright © Acme Inc",
  "icon" : {
    "url" : "https://www.example.com/copyright-license.png"
  }
}

Error responses

The following error situations are possible:

ID Response code Description
not_permitted 403 (Forbidden) User is not permitted to retrieve publication license details.
not_linked_to_organization 400 (Bad request) No specific organization was requested, and the requesting user is not linked to an organization.
not_found 404 (Not found) Requested organization does not exist.