---
title: "Check an intended use against a license: permitted, prohibited, needs review or not documented, with duties and an uncertainty block (level: none, review or undocumented; reasons; human_review_required). A check reads license terms only; its verdicts are not receipt verdicts (allowed, blocked) and never convert into them"
method: GET
path: "/v1/licenses/check"
tags: ["Rights desk"]
---

# Check an intended use against a license: permitted, prohibited, needs review or not documented, with duties and an uncertainty block (level: none, review or undocumented; reasons; human_review_required). A check reads license terms only; its verdicts are not receipt verdicts (allowed, blocked) and never convert into them

`GET /v1/licenses/check`

## Request

- Base URL: `https://www.rightshold.com`
- URL: `https://www.rightshold.com/v1/licenses/check`
- Auth: none required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object: Inferred from 4 recorded responses; required fields appeared in every one; additional properties may appear.
  - `verdict` string, required
  - `answer` string, required
  - `uncertainty` object, required
    - `level` string, required
    - `reasons` string[], required
    - `human_review_required` boolean, required
  - `uses_evaluated` string[], required
  - `duties` string[], required
  - `findings` object[], required
    - `code` string, required
    - `explanation` string, required
  - `next_actions` string[], required
  - `license` object, required
    - `curation` string, required
    - `id` string, required
    - `name` string, required
    - `short` string, required
    - `family` string, required
    - `version` string, required
    - `url` string, required
    - `summary` string, required
    - `suits` string[], required
    - `permissions` string[], required
    - `prohibitions` string[], required
    - `needs_review` string[], required
    - `prohibited_combinations` unknown[], required
      - unknown
    - `duties` string[], required
    - `notes` string[], required
    - `reference_hash` string, required
    - `profile_version` string, required
    - `reviewer` string, required
    - `page` string, required
    - `odrl` object, required
      - `@context` union[], required
        - union
          - string
          - object
      - `@type` string, required
      - `uid` string, required
      - `profile` string, required
      - `permission` object[], required
      - `prohibition` object[], required
      - `rs:needsReview` string[], required
    - `reference_hash_covers` string[], required
  - `cache` object, required
    - `key` string, required
    - `deterministic` boolean, required
    - `depends_on` object, required
      - `reference_hash` string, required
      - `profile_version` string, required
    - `max_age_seconds` integer, required
    - `note` string, required
  - `limitations` string[], required
  - `next_action` object, required
    - `action` string, required
    - `label` string, required
    - `why` string, required
    - `needs` string, required
    - `tool` string
    - `rest` string
    - `arguments` object
      - `asset` object, required
        - `sha256` string, required
        - `name` string, required
      - `license` string, required
      - `intended_use` string, required

## Other responses

- `400`: Problem details: a stable error code, type URI, title, status and an explanation
- `401`: Problem details: a stable error code, type URI, title, status and an explanation
- `404`: Problem details: a stable error code, type URI, title, status and an explanation
- `405`: Problem details: a stable error code, type URI, title, status and an explanation
- `422`: Problem details: a stable error code, type URI, title, status and an explanation
- `429`: Request budget exhausted; retry after Retry-After seconds
- `500`: Problem details: a stable error code, type URI, title, status and an explanation
- `4XX`: {error, detail}

---

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