---
title: "Get commission quote for a capability request"
method: GET
path: "/v1/capability-requests/{request_id}/quote"
tags: ["public_api", "external", "capability-requests"]
---

# Get commission quote for a capability request

`GET /v1/capability-requests/{request_id}/quote`

## Request

- Base URL: `https://api.hydracept.com`
- URL: `https://api.hydracept.com/v1/capability-requests/{request_id}/quote`
- Auth: HTTP bearer

Human-paid implementation quote (quoteKind=commission). Never pass this quoteId as execution.quoteId on jobs.

## Path parameters

- `request_id` string, required

## Response `200`

Successful Response

- CapabilityQuoteView
  - `quoteId` string, required: Commission quote for a capability REQUEST. Humans pay at approvalUrl. Never pass this id as execution.quoteId on jobs or invoke.
  - `quoteKind` 'commission'
  - `notExecutionQuoteId` boolean: This quoteId is not valid for job execution.quoteId.
  - `requestId` string, required
  - `requestRevisionId` string, required
  - `requestHash` string, required
  - `commissionPrice` Money, required: Hydracept price before transactional tax. ``amountMicros`` is authority.
    - `amountMicros` integer, required
    - `currency` string, required
    - `amountMinor` integer, required
    - `display` string, required
  - `taxTreatment` string
  - `runtimePricing` RetailPricingContract, required
    - `mode` 'free' | 'zero' | 'fixed' | 'metered' | 'hybrid', required
    - `billingCurrency` string, required
    - `display` string, required
    - `estimateRequired` boolean
    - `quoteEndpoint` string, nullable
    - `estimateEndpoint` string, nullable: HTTP alias of quoteEndpoint (same 0.3 retail quote).
    - `pricingVersion` string, required
    - `pricingFactors` PricingFactor[]
      - `key` string, required
      - `display` string, required
      - `kind` 'selection' | 'usage-ceiling' | 'measured-usage' | 'retention'
      - `requiredForEstimate` boolean
    - `startingAt` Money: Hydracept price before transactional tax. ``amountMicros`` is authority.
      - `amountMicros` integer, required
      - `currency` string, required
      - `amountMinor` integer, required
      - `display` string, required
    - `pricingContext` 'catalog_default' | 'account'
    - `authoritativeForExecution` boolean
    - `examples` object[]
    - `status` string, nullable
    - `committedUntil` string, nullable
  - `delivery` object
  - `guarantee` object
  - `expiresAt` string, date-time, required
  - `approval` object

## Other responses

- `401`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `403`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `404`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `422`: Validation failure: public envelope plus Pydantic `detail` / `validationErrors`
- `429`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `500`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `502`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `503`: Structured public error envelope (`code`, `message`, `requestId`, …)

---

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