GET organization/…

Retrieves the details of an organization.

💡 Please note

Only the details for the "own" organization may be retrieved.

Resource URL

https://www.drillster.com/api/2.1.1/organization

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

Parameters

Field	Type	Description
`organization_id` optional	String	The organization ID to retrieve details for. If omitted, the details for user's own organization are returned. Example value: `nPjYUn0upc8dIm7yzTIBgQ`

Response

An 2.1.1 Organization object with the details of the requested organization.

Example request

GET https://www.drillster.com/api/2.1.1/organization

Response

{
  "type": "ORGANIZATION",
  "id": "nPjYUn0upc8dIm7yzTIBgQ",
  "name": "Acme Corp",
  "emailAddress": "info@example.com",
  "locale": "en_US",
  "contract": {
    "type": "BUSINESS"
  }
}

Error responses

The following error situations are possible:

ID	Description
`not_linked_to_organization`	No specific organization was requested, and the requesting user is not linked to an organization.
`not_found`	Requested organization does not exist.

Last updated on 2025-04-18