---
title: "Read an organization's complimentary access and grants"
method: GET
path: "/v1/admin/organizations/{organizationId}/control-panel"
tags: ["Admin"]
---

# Read an organization's complimentary access and grants

`GET /v1/admin/organizations/{organizationId}/control-panel`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/admin/organizations/{organizationId}/control-panel`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns effective complimentary access, usage balances and a cursor-paginated grants list. Include history to see revoked, expired and exhausted grants. Platform administrators only.

## Path parameters

- `organizationId` string, required

## Query parameters

- `history` '0' | '1'
- `cursor` string
- `limit` integer

## Response `200`

Organization control panel.

- object
  - `enabled` boolean, required
  - `generatedAt` string, date-time, required
  - `access` object, required
    - `freeAuto` object, required
      - `setting` 'default' | 'enabled' | 'disabled', required
      - `enabled` boolean, required
      - `source` string, required
    - `openworkWeb` object, required
      - `setting` 'default' | 'enabled' | 'disabled', required
      - `enabled` boolean, required
      - `source` string, required
  - `freeAuto` object, required
    - `weeklyLimitUsd` number, required
    - `extraRemainingUsd` number, required
    - `unlimited` boolean, required
  - `grants` object[], required
    - `id` string, required
    - `feature` 'freeAuto' | 'openworkWeb', required
    - `kind` 'access' | 'usage' | 'unlimited', required
    - `amountUsd` number, nullable, required
    - `usedUsd` number, required
    - `remainingUsd` number, nullable, required
    - `startsAt` string, date-time, required
    - `expiresAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `revokedAt` string, date-time, nullable, required
    - `createdByUserId` string, required
    - `reason` string, required
    - `state` 'scheduled' | 'active' | 'expired' | 'exhausted' | 'revoked' | 'blocked', required
  - `legacyWebAccess` boolean, required
  - `nextCursor` string, nullable, required: Pass as cursor to fetch the next grants page; null on the last page.

## Other responses

- `400`: Invalid organization, grant or request.
- `401`: Sign in required.
- `403`: Platform administrator required.
- `404`: Organization, grant or rollout not available.
- `409`: The request conflicts with an existing grant or paid Web subscription.

## Changes

- **2026-10-20** `4466ec930cde`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/admin/organizations/:organizationId/control-panel/get.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) · [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/e6eb4e5ce8a3?raw)