Open App

Organisations

API endpoints for organisations

List organisations

GET /api/v1/organisations

Example request

curl -X GET \
"https://api.example.com/api/v1/organisations" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": [
    {
      "id": "string",
      "name": "string"
    }
  ]
}

Other statuses: 401.

Response body type

{ data: Organisation[] }


Get organisation by id

GET /api/v1/organisations/{id}

Parameters

NameInTypeRequiredDescription
idpathstringYesPath parameter.

Example request

curl -X GET \
"https://api.example.com/api/v1/organisations/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": {
    "id": "string",
    "name": "string"
  }
}

Other statuses: 401, 404.

Response body type

{ data: Organisation }