---
title: "Check whether a subject can access a harness"
method: GET
path: "/entitlements/check"
---

# Check whether a subject can access a harness

`GET /entitlements/check`

## Request

- Base URL: `https://superskill.sh/api`
- URL: `https://superskill.sh/api/entitlements/check`
- Auth: HTTP bearer

Bot-facing read-only check. Requires ORGS_ENABLED=true and a Bearer org token with entitlements:read scope. The token authorizes the check but is never treated as a buyer entitlement.

## Query parameters

- `subject` string, required
- `harness` string, required
- `version` string

## Response `200`

Entitlement decision

- EntitlementCheck
  - `ok` boolean, required
  - `entitled` boolean, required
  - `status` 'free' | 'entitled' | 'payment_required', required
  - `owner` string, required
  - `repo` string, required
  - `version` string, required
  - `subject_type` 'user' | 'wallet' | 'org', required
  - `subject_id` string, required
  - `pricing` object, required

## Other responses

- `400`: Bad request
- `401`: Authorization required
- `403`: Authorization was provided but is not allowed for this action
- `404`: Resource not found

---

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