---
title: "GET /v1/capabilities — Machine-readable capability surface for autonomous clients."
method: GET
path: "/v1/capabilities"
tags: ["Discovery"]
---

# GET /v1/capabilities — Machine-readable capability surface for autonomous clients.

`GET /v1/capabilities`

## Request

- Base URL: `https://api.stockfilm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stockfilm.com/v1/capabilities`
- Auth: API key in header `Authorization`

## Response `200`

Agent capability document

- CapabilitiesResponse
  - `auth` CapabilitiesAuthModel, required
    - `api_key_headers` string[], required
    - `hmac_payload_format` string, required
    - `hmac_required_methods` string[], required
    - `idempotency_header` string, required
    - `idempotency_required_for_mutations` boolean, required
    - `max_clock_skew_seconds` integer, required
  - `docs_url` string, required
  - `key_endpoints` CapabilitiesEndpoint[], required
    - `method` string, required
    - `path` string, required
    - `purpose` string, required
  - `openapi_url` string, required
  - `pricing` CapabilitiesPricing, required: Flat per-clip pricing advertised to agents.
    - `amount_cents` integer, required
    - `currency` string, required
    - `model` string, required: Always "flat": one price per clip license, regardless of scope or resolution.
    - `note` string, required
    - `tier_label` string, required
  - `rails` CapabilitiesRail[], required
    - `instruction_fields` string[], required
    - `payment_statuses` string[], required
    - `rail` 'solana_sol' | 'solana_usdc', required: Canonical public payment rail values for API contracts.
    - `settlement_asset` string, required
  - `search_filters` string[], required
  - `service` string, required
  - `usage_scopes` string[], required
  - `version` string, required
  - `webhooks` string[], required
  - `website_url` string, required
  - `workflow` string[], required

---

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