> ## Documentation Index > Fetch the complete documentation index at: https://docs.kordless.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a quote > Returns the Quote Intent and Receipt for a quote created with the same API key. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/quotes/{quoteIntentId} openapi: 3.1.0 info: title: Kordless API version: 1.0.0 description: | The Kordless API creates deterministic quotes against published Book Versions and returns immutable Quote Receipts. The same pipeline serves headless API-key traffic, Business-member sessions, and anonymous end-customer surfaces. ## Authentication Headless routes require a secret API key as a bearer token: ``` Authorization: Bearer sk_test_... ``` Test keys use the `sk_test_` prefix; Live keys use `sk_live_`. The key binds a Workspace, Project, and one Environment — a Test key can never address Live data. Member routes under `/v1/businesses/{businessId}` authenticate the caller's session and Business membership. The `/v1/public_quotes` routes are anonymous by design. ## Idempotency Quote creation accepts an optional `idempotencyKey` in the request body. Retrying with the same key and the same payload replays the original Quote; the same key with a different payload returns `409 idempotency_conflict`. When omitted, the server generates an `auto_` key. ## Envelopes and request IDs Success responses are `{ "data": …, "requestId": … }`; failures are `{ "error": { "code", "message", "requestId", "details?" } }`. Every response also carries an `x-request-id` header, echoed on created Quotes as `requestCorrelationId`. servers: - url: https://your-kordless-instance.com description: Replace with your Kordless instance base URL security: - BearerAuth: [] tags: - name: Quotes description: Headless quote creation and retrieval with an API key. - name: Public quotes description: Anonymous end-customer quotes against the Live-published Book. - name: Business portal description: Member-session routes used by the hosted Business Portal. - name: API keys description: >- Workspace-session routes for the API-key lifecycle (create, rotate, revoke). - name: Webhooks description: >- Workspace-session routes for webhook endpoints, deliveries, test events, and replay. - name: Request logs description: Workspace-session log search and Quote Intent traces. - name: Status description: Anonymous liveness signal. paths: /v1/quotes/{quoteIntentId}: get: tags: - Quotes summary: Retrieve a quote description: >- Returns the Quote Intent and Receipt for a quote created with the same API key. operationId: getQuote parameters: - name: quoteIntentId in: path required: true schema: type: string format: uuid description: The Quote Intent ID. responses: '200': description: The Quote Intent and its Receipt. content: application/json: schema: $ref: '#/components/schemas/GetQuoteResponse' '401': $ref: '#/components/responses/InvalidApiKey' '404': $ref: '#/components/responses/QuoteNotFound' components: schemas: GetQuoteResponse: type: object required: - data - requestId properties: data: type: object required: - intent - receipt properties: intent: $ref: '#/components/schemas/QuoteIntent' receipt: $ref: '#/components/schemas/QuoteReceipt' requestId: type: string QuoteIntent: type: object description: The persisted quote request. properties: id: type: string format: uuid workspaceId: type: string format: uuid projectId: type: string format: uuid environmentId: type: string format: uuid bookId: type: string format: uuid bookVersionId: type: string format: uuid nullable: true description: Pinned at creation from the Environment's publication pointer. status: type: string enum: - created - requires_input - processing - succeeded - failed - expired source: type: string enum: - hosted - api idempotencyKey: type: string requestCorrelationId: type: string description: Matches the `x-request-id` of the creating request. inputs: type: object properties: offeringId: type: string factors: type: object additionalProperties: type: - string - 'null' expiresAt: type: string format: date-time nullable: true createdAt: type: string format: date-time QuoteReceipt: type: object description: | Immutable outcome evidence. Exactly one evidence channel is populated: `computation` on success, `missingInputs` when input is required, or `failure` on an unpriced outcome. properties: id: type: string format: uuid quoteIntentId: type: string format: uuid outcome: type: string enum: - succeeded - requires_input - failed source: type: string enum: - hosted - api bookVersionId: type: string format: uuid nullable: true description: Always set on succeeded receipts. computation: $ref: '#/components/schemas/QuoteComputation' missingInputs: type: array items: type: string description: >- Dotted paths such as `factors.vehicle_size` or `offeringId`. Empty unless the outcome is `requires_input`. failure: type: object nullable: true properties: code: type: string description: >- For example `no_published_version`, `unknown_offering`, `unknown_factor`, `unknown_factor_option`. message: type: string idempotencyKey: type: string requestCorrelationId: type: string latencyMs: type: integer minimum: 0 createdAt: type: string format: date-time ErrorEnvelope: type: object required: - error properties: error: type: object required: - code - message - requestId properties: code: type: string message: type: string requestId: type: string details: type: object description: >- Optional structured context, for example `fields` on validation failures. QuoteComputation: type: object nullable: true description: >- Present only on `succeeded` receipts. All amounts are integer minor units. properties: currency: type: string description: ISO 4217 currency code. lineItems: type: array minItems: 1 items: $ref: '#/components/schemas/ReceiptLineItem' totalMinor: type: integer minimum: 0 description: Always reconciles to the sum of line items. paymentTerms: type: object properties: depositBasisPoints: type: integer minimum: 0 maximum: 10000 depositMinor: type: integer minimum: 0 balanceDueMinor: type: integer minimum: 0 description: Deposit plus balance always reconciles to `totalMinor`. conditions: type: array items: type: string derivation: type: array minItems: 1 items: $ref: '#/components/schemas/DerivationEntry' ReceiptLineItem: type: object properties: kind: type: string enum: - base - surcharge - discount - guardrail label: type: string amountMinor: type: integer ruleId: type: string nullable: true DerivationEntry: type: object description: One step of the deterministic evaluation, in order. properties: sequence: type: integer minimum: 0 phase: type: string enum: - base - baseOverride - scopedModifier - conditionalModifier - discount - guardrail - paymentTerms ruleId: type: string nullable: true ruleType: type: string nullable: true status: type: string enum: - applied - skipped reason: type: string deltaMinor: type: integer runningTotalMinor: type: integer minimum: 0 responses: InvalidApiKey: description: Missing, malformed, or unknown API key. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_api_key message: A valid API key is required. requestId: req_9f8e7d6c QuoteNotFound: description: No Quote with that ID is visible to this credential or surface. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: quote_not_found message: The Quote Intent does not exist in this scope. requestId: req_9f8e7d6c securitySchemes: BearerAuth: type: http scheme: bearer description: >- Secret API key (`sk_test_…` or `sk_live_…`). The key binds a Workspace, Project, and Environment. ````