---
title: "Inspect a CAP contract"
method: GET
path: "/capabilities/{capability_id}"
tags: ["Capabilities"]
---

# Inspect a CAP contract

`GET /capabilities/{capability_id}`

## Request

- Base URL: `https://qveris.ai/api/v1`
- URL: `https://qveris.ai/api/v1/capabilities/{capability_id}`
- Auth: HTTP bearer

Return the current published CAP contract. `contract_version` and `schema_hash` identify the exact contract; legacy CAP records may omit both fields. The response always discloses verification evidence and execution restrictions; only explicit execution blockers deny Call.

## Path parameters

- `capability_id` string, required

## Query parameters

- `run_id` string
- `provider_id` string

## Response `200`

Successful Response

- PublicCapabilityDetailResponse
  - `capability_id` string, required
  - `name` string
  - `description` string
  - `params` object[]
  - `field_spec` object
  - `contract_version` integer: Published CAP contract version.
  - `schema_hash` string: SHA-256 identity of the published CAP contract.
  - `verification_status` 'unverified' | 'verifying' | 'verified' | 'stale' | 'failed' | 'restricted', required
  - `verification` PublicCatalogVerification, required: Fail-closed catalog verification result. Only records with every required check passed, a valid test digest, and an unexpired 24-hour evidence window are verified.
    - `status` 'unverified' | 'verifying' | 'verified' | 'stale' | 'failed' | 'restricted', required
    - `policy_version` string, required
    - `required_checks` string[], required
    - `checks` PublicVerificationCheck[], required
      - `name` 'schema' | 'authentication' | 'description_contract' | 'provider_identity' | 'permissions' | 'freshness' | 'live_check', required
      - `status` 'missing' | 'verifying' | 'passed' | 'stale' | 'failed' | 'restricted', required
      - `checked_at` string, date-time, nullable
      - `evidence_digest` string, nullable
      - `reason` string, nullable
    - `verified_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `test_run_digest` string, nullable
    - `quality_issues` string[], required
  - `execution_restrictions` PublicExecutionRestrictions, required: Additive readiness axes and action guidance. Discovery remains available for unknown or incomplete evidence. Explicit restrictions fail closed through blocked_actions. Missing provider restriction metadata is not an execution denial: a candidate with usable input and a fixed per-call catalog price may be called directly. The catalog price is an estimate, not a reserved quote; variable pricing still requires budget confirmation. Probe is optional unless preflight validation or a current quote is needed. Call remains subject to live authorization, availability, and billing checks.
    - `callable` boolean, required
    - `eligibility` 'unknown' | 'not_required' | 'required' | 'restricted', required
    - `license` 'unknown' | 'not_required' | 'required' | 'approved' | 'restricted', required
    - `regions` PublicRegionRestrictions, required
      - `allow` string[], required
      - `deny` string[], required
    - `commercial_use` 'unknown' | 'allowed' | 'conditional' | 'prohibited', required
    - `data_as_of` string, date-time, nullable
    - `warnings` string[], required
    - `technical` 'unknown' | 'ready' | 'blocked'
    - `authentication` 'unknown' | 'ready' | 'required' | 'blocked'
    - `region_status` 'unknown' | 'ready' | 'conditional' | 'blocked'
    - `freshness` 'unknown' | 'fresh' | 'stale' | 'failed'
    - `price_certainty` 'unknown' | 'estimated' | 'exact'
    - `confidence` number
    - `allowed_actions` string[]
    - `blocked_actions` string[]
    - `next_action` string
    - `retryable` boolean
  - `remaining_credits` number, nullable

## Other responses

- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Delegation constraint rejected
- `404`: Capability not found
- `408`: Request timeout
- `422`: Validation Error
- `500`: Request failed

---

[API](https://skmtc.dev/qveris/apis/qveris-public-rest-api.md) · [All operations](https://skmtc.dev/qveris/apis/qveris-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qveris/apis/qveris-public-rest-api/revisions/7b78aeef092a?raw)