---
title: "List an organisation's effective tool entitlements"
method: GET
path: "/api/v1/orgs/tools"
tags: ["org-tools"]
---

# List an organisation's effective tool entitlements

`GET /api/v1/orgs/tools`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/api/v1/orgs/tools`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

## Query parameters

- `org_id` string, required: Keycloak organisation id (must appear in the JWT org_ids claim)

## Response `200`

Successful Response

- OrgToolsResponse
  - `organisation_id` string, required
  - `tier` string, required
  - `tools` OrgToolItemResponse[], required
    - `tool_id` string, required
    - `tier_default_included` boolean, required
    - `enabled` boolean, required
    - `state` string, required
    - `unlock_tier` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)