GET /capabilities/{capability_id}
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.
REST API overview · OpenAPI JSON · OpenAPI YAML
| Stability | Authentication | Cost | Operation ID |
|---|---|---|---|
| Published | Bearer API key | Free | capabilities_detail_api_v1_capabilities__capability_id__get |
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
capability_id | path | Yes | string | — |
run_id | query | No | string | Run identifier required by constrained delegation tokens. |
provider_id | query | No | string | Provider target required by constrained delegation tokens. |
This operation has no JSON request body.
curl --request GET \
--url "https://qveris.ai/api/v1/capabilities/YOUR_CAPABILITY_ID" \
--header "Authorization: Bearer $QVERIS_API_KEY"
const response = await fetch("https://qveris.ai/api/v1/capabilities/YOUR_CAPABILITY_ID", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
},
})
if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
import os
import requests
response = requests.request(
"GET",
"https://qveris.ai/api/v1/capabilities/YOUR_CAPABILITY_ID",
headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())
| Status | Meaning | Schema |
|---|---|---|
200 | Successful Response | PublicCapabilityDetailResponse |
401 | Unauthorized | PublicApiError |
402 | Insufficient credits | PublicApiError |
403 | Delegation constraint rejected | PublicApiError |
404 | Capability not found | PublicApiError |
408 | Request timeout | PublicApiError |
422 | Validation Error | HTTPValidationError |
500 | Request failed | PublicApiError |
{
"capability_id": "MKT.BARS.EOD",
"name": "End-of-Day Bars",
"description": "Daily market bars for a symbol.",
"contract_version": 7,
"schema_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"remaining_credits": 995,
"verification_status": "unverified",
"verification": {
"status": "unverified",
"policy_version": "catalog-verification-v1",
"required_checks": [
"schema",
"authentication",
"description_contract",
"provider_identity",
"permissions",
"freshness",
"live_check"
],
"checks": [
{
"name": "schema",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": "schema_missing"
},
{
"name": "authentication",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": "authentication_path_missing"
},
{
"name": "description_contract",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": null
},
{
"name": "provider_identity",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": "provider_id_missing"
},
{
"name": "permissions",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": null
},
{
"name": "freshness",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": "expires_at_missing"
},
{
"name": "live_check",
"status": "missing",
"checked_at": null,
"evidence_digest": null,
"reason": "live_check_samples_missing"
}
],
"verified_at": null,
"expires_at": null,
"test_run_digest": null,
"quality_issues": [
"live_check_samples_missing",
"schema_missing",
"authentication_path_missing",
"provider_id_missing",
"permission_disclosure_incomplete",
"verified_at_missing",
"expires_at_missing",
"test_run_digest_missing",
"verification_status_missing"
]
},
"execution_restrictions": {
"callable": false,
"technical": "unknown",
"authentication": "unknown",
"eligibility": "unknown",
"license": "unknown",
"regions": {
"allow": [],
"deny": []
},
"region_status": "unknown",
"commercial_use": "unknown",
"freshness": "unknown",
"price_certainty": "unknown",
"data_as_of": null,
"warnings": [],
"confidence": 0,
"allowed_actions": [
"discover",
"inspect",
"probe"
],
"blocked_actions": [
"execute"
],
"next_action": "probe",
"retryable": true
}
}
POST Discover capabilities · POST Inspect capabilities · POST Probe a capability · POST Call a capability
Was this page helpful?