Source Markdown Contents Code and setup Optional section MCP references Companion files Changes
The actual file
Source Markdown The saved llms.txt text, displayed as source. The file belongs to its publisher; the live endpoint may change.
Showing the first 18000 characters. Load the complete file to read the remainder.
# Firmly Docs
This file provides guidance for Large Language Models (LLMs) on navigating and understanding the content available on the Firmly documentation site (https://developers.firmly.ai). Use the file at https://developers.firmly.ai/llms-full.txt for a single file with all the content embedded.
## General
- [API Explorer](https://developers.firmly.ai/api-explorer/): interactive live API client — browse endpoints and run requests against the sandbox
- [OpenAPI specification](https://developers.firmly.ai/openapi.json): the machine-readable API contract (OpenAPI 3.0.3) — every path, parameter, request/response schema. Start here if you are generating a client or reasoning about the API programmatically.
## API Reference
- [API Reference](https://developers.firmly.ai/api-reference/index.md)
- [Add Addons](https://developers.firmly.ai/api-reference/addon-management/add-addon/index.md)
- [Add Line Item](https://developers.firmly.ai/api-reference/cart-management/add-line-item/index.md)
- [Add Promo Codes](https://developers.firmly.ai/api-reference/promotions/add-promo-codes/index.md)
- [Addon Management](https://developers.firmly.ai/api-reference/addon-management/index.md)
- [Affiliate](https://developers.firmly.ai/api-reference/affiliate/index.md)
- [Agentic Pay](https://developers.firmly.ai/api-reference/agentic-pay/index.md)
- [Authentication](https://developers.firmly.ai/api-reference/authentication/index.md)
- [Authorize Klarna Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/klarna/authorize/index.md)
- [Authorize PayPal Express Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/paypal/authorize/index.md)
- [Browser Session](https://developers.firmly.ai/api-reference/authentication/browser-session/index.md)
- [Cart Lifecycle](https://developers.firmly.ai/api-reference/cart-management/cart-lifecycle/index.md)
- [Cart Management](https://developers.firmly.ai/api-reference/cart-management/index.md)
- [Catalog](https://developers.firmly.ai/api-reference/catalog/index.md)
- [Checkout](https://developers.firmly.ai/api-reference/checkout/index.md)
- [Clear Cart](https://developers.firmly.ai/api-reference/cart-management/clear-cart/index.md)
- [Clear Promo Codes](https://developers.firmly.ai/api-reference/promotions/clear-promo-codes/index.md)
- [Complete Google Pay Order](https://developers.firmly.ai/api-reference/payment/express-checkout/google-pay/complete-order/index.md)
- [Complete Klarna Order](https://developers.firmly.ai/api-reference/payment/express-checkout/klarna/complete-order/index.md)
- [Complete Order](https://developers.firmly.ai/api-reference/payment/complete-order-v2/index.md)
- [Complete PayPal Express Order](https://developers.firmly.ai/api-reference/payment/express-checkout/paypal/complete-order/index.md)
- [Create Intent](https://developers.firmly.ai/api-reference/agentic-pay/create-intent/index.md)
- [Delete Card](https://developers.firmly.ai/api-reference/agentic-pay/delete-card/index.md)
- [Discovery](https://developers.firmly.ai/api-reference/discovery/index.md)
- [Enroll Card](https://developers.firmly.ai/api-reference/agentic-pay/enroll/index.md)
- [Errors & Conventions](https://developers.firmly.ai/api-reference/errors-and-conventions/index.md)
- [Express Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/index.md)
- [Get Active Carts](https://developers.firmly.ai/api-reference/session/get-active-carts/index.md)
- [Get Active Domains](https://developers.firmly.ai/api-reference/session/get-active-domains/index.md)
- [Get All Products](https://developers.firmly.ai/api-reference/catalog/get-all-products/index.md)
- [Get Availability](https://developers.firmly.ai/api-reference/shipment-configuration/get-availability/index.md)
- [Get Card Art](https://developers.firmly.ai/api-reference/agentic-pay/card-art/index.md)
- [Get Cart](https://developers.firmly.ai/api-reference/cart-management/get-cart/index.md)
- [Get Consents](https://developers.firmly.ai/api-reference/checkout/get-consents/index.md)
- [Get Postal Code](https://developers.firmly.ai/api-reference/session/get-postal-code/index.md)
- [Get Product from URL](https://developers.firmly.ai/api-reference/catalog/get-product-from-url/index.md)
- [Get Public Key](https://developers.firmly.ai/api-reference/payment/get-public-key/index.md)
- [Get Shipping Methods](https://developers.firmly.ai/api-reference/shipment-configuration/get-shipping-methods/index.md)
- [Get a Product](https://developers.firmly.ai/api-reference/catalog/get-product/index.md)
- [Google Pay Express Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/google-pay/index.md)
- [Headless SDK](https://developers.firmly.ai/api-reference/headless-sdk/index.md)
- [Iframe Callback](https://developers.firmly.ai/api-reference/agentic-pay/iframe-callback/index.md)
- [Intent Challenge](https://developers.firmly.ai/api-reference/agentic-pay/intent-challenge/index.md)
- [Klarna Express Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/klarna/index.md)
- [Pagination](https://developers.firmly.ai/api-reference/pagination/index.md)
- [PayPal Express Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/paypal/index.md)
- [Payment](https://developers.firmly.ai/api-reference/payment/index.md)
- [Place Order](https://developers.firmly.ai/api-reference/payment/place-order-v2/index.md)
- [Promotions](https://developers.firmly.ai/api-reference/promotions/index.md)
- [Rate Limits](https://developers.firmly.ai/api-reference/rate-limits/index.md)
- [Remove Addon](https://developers.firmly.ai/api-reference/addon-management/remove-addon/index.md)
- [Resume After Challenge](https://developers.firmly.ai/api-reference/payment/complete-order-v2-resume/index.md)
- [Search Products](https://developers.firmly.ai/api-reference/discovery/search/index.md)
- [Select Card](https://developers.firmly.ai/api-reference/agentic-pay/select-card/index.md)
- [Server-to-Server Authentication](https://developers.firmly.ai/api-reference/authentication/server-to-server/index.md)
- [Session Transfer](https://developers.firmly.ai/api-reference/session/session-transfer/index.md)
- [Session](https://developers.firmly.ai/api-reference/session/index.md)
- [Set Billing Info](https://developers.firmly.ai/api-reference/checkout/set-billing-info/index.md)
- [Set Cart Attribution](https://developers.firmly.ai/api-reference/cart-management/set-attribution/index.md)
- [Set Consents](https://developers.firmly.ai/api-reference/checkout/set-consents/index.md)
- [Set Fulfillment Type](https://developers.firmly.ai/api-reference/shipment-configuration/set-fulfillment-type/index.md)
- [Set Postal Code](https://developers.firmly.ai/api-reference/session/set-postal-code/index.md)
- [Set Shipping Info](https://developers.firmly.ai/api-reference/checkout/set-shipping-info/index.md)
- [Set Shipping Method](https://developers.firmly.ai/api-reference/shipment-configuration/set-shipping-method/index.md)
- [Shipment Configuration](https://developers.firmly.ai/api-reference/shipment-configuration/index.md)
- [Shipping & Fulfillment](https://developers.firmly.ai/api-reference/shipment-configuration/shipping-and-fulfillment/index.md)
- [Standard cart](https://developers.firmly.ai/api-reference/standard-flow/cart/index.md)
- [Standard checkout](https://developers.firmly.ai/api-reference/standard-flow/checkout/index.md)
- [Standard flow](https://developers.firmly.ai/api-reference/standard-flow/index.md)
- [Standard order](https://developers.firmly.ai/api-reference/standard-flow/place-order/index.md)
- [Start Journey](https://developers.firmly.ai/api-reference/affiliate/start-journey/index.md)
- [Start Klarna Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/klarna/start/index.md)
- [Start PayPal Express Checkout](https://developers.firmly.ai/api-reference/payment/express-checkout/paypal/start/index.md)
- [Trigger Enrollment](https://developers.firmly.ai/api-reference/agentic-pay/trigger-enrollment/index.md)
- [Update Line Item](https://developers.firmly.ai/api-reference/cart-management/update-line-item/index.md)
- [Verify Enrollment](https://developers.firmly.ai/api-reference/agentic-pay/verify-enrollment/index.md)
- [Wallet Complete Order](https://developers.firmly.ai/api-reference/payment/wallet-complete-order/index.md)
- [completeOrder](https://developers.firmly.ai/api-reference/headless-sdk/complete-order/index.md)
- [createIntent](https://developers.firmly.ai/api-reference/headless-sdk/create-intent/index.md)
- [deleteCard](https://developers.firmly.ai/api-reference/headless-sdk/delete-card/index.md)
- [enrollCard](https://developers.firmly.ai/api-reference/headless-sdk/enroll-card/index.md)
- [registerPasskey](https://developers.firmly.ai/api-reference/headless-sdk/register-passkey/index.md)
- [selectCard](https://developers.firmly.ai/api-reference/headless-sdk/select-card/index.md)
- [triggerOtp](https://developers.firmly.ai/api-reference/headless-sdk/trigger-otp/index.md)
- [verifyOtp](https://developers.firmly.ai/api-reference/headless-sdk/verify-otp/index.md)
## Contact us
- [Contact us](https://developers.firmly.ai/contact/index.md)
## Cookbook
- [1-Step Checkout](https://developers.firmly.ai/cookbook/one-step-checkout/index.md)
- [Advanced Checkout Guide](https://developers.firmly.ai/cookbook/advanced-checkout-guide/index.md)
- [Cart API Implementation Guide](https://developers.firmly.ai/cookbook/full-cart-api-guide/index.md)
- [Cookbook](https://developers.firmly.ai/cookbook/index.md)
- [Handle multi-shipment carts](https://developers.firmly.ai/cookbook/handle-multi-shipment/index.md)
- [Stack card-linked offers with promo codes](https://developers.firmly.ai/cookbook/stack-card-linked-offers-with-promo-codes/index.md)
- [Standard Checkout Guide](https://developers.firmly.ai/cookbook/standard-checkout-guide/index.md)
## FAQ
- [FAQ](https://developers.firmly.ai/faq/index.md)
## For Destinations
- [Authentication](https://developers.firmly.ai/for-destinations/authentication/index.md)
- [Destination Dashboard](https://developers.firmly.ai/for-destinations/destination-dashboard/index.md)
- [For Destinations](https://developers.firmly.ai/for-destinations/index.md)
- [Going Live](https://developers.firmly.ai/for-destinations/going-live/index.md)
- [Onboarding](https://developers.firmly.ai/for-destinations/onboarding/index.md)
- [Sandbox Setup](https://developers.firmly.ai/for-destinations/sandbox-setup/index.md)
- [Try the Sandbox](https://developers.firmly.ai/for-destinations/try-the-sandbox/index.md)
## For Merchants
- [Catalog & Pricing](https://developers.firmly.ai/for-merchants/catalog-and-pricing/index.md)
- [Credentials & API Access](https://developers.firmly.ai/for-merchants/credentials-and-api-access/index.md)
- [For Merchants](https://developers.firmly.ai/for-merchants/index.md)
- [Going Live](https://developers.firmly.ai/for-merchants/going-live/index.md)
- [Merchant Quickstart](https://developers.firmly.ai/for-merchants/quickstart/index.md)
- [Onboarding walkthrough](https://developers.firmly.ai/for-merchants/onboarding/index.md)
- [Supported Platforms](https://developers.firmly.ai/for-merchants/supported-platforms/index.md)
## Foundations
- [Data Flow](https://developers.firmly.ai/foundations/data-flow/index.md)
- [Foundations](https://developers.firmly.ai/foundations/index.md)
- [Lifecycle and States](https://developers.firmly.ai/foundations/lifecycle-and-states/index.md)
- [Security Model](https://developers.firmly.ai/foundations/security-model/index.md)
## How Firmly Works
- [How Firmly Works](https://developers.firmly.ai/how-firmly-works/index.md)
## Resources
- [Addon schemas](https://developers.firmly.ai/resources/schemas/addons/index.md)
- [Changelog](https://developers.firmly.ai/resources/changelog/index.md)
- [Common types](https://developers.firmly.ai/resources/schemas/common-types/index.md)
- [Error response schema](https://developers.firmly.ai/resources/schemas/error-response/index.md)
- [Fulfillment schemas](https://developers.firmly.ai/resources/schemas/fulfillment/index.md)
- [Glossary](https://developers.firmly.ai/resources/glossary/index.md)
- [LineItem schema](https://developers.firmly.ai/resources/schemas/line-item/index.md)
- [Migrating from another commerce vendor](https://developers.firmly.ai/resources/migrating-from-another-commerce-vendor/index.md)
- [Request schemas](https://developers.firmly.ai/resources/schemas/request-schemas/index.md)
- [Resources](https://developers.firmly.ai/resources/index.md)
- [Schemas](https://developers.firmly.ai/resources/schemas/index.md)
- [Shipment schema](https://developers.firmly.ai/resources/schemas/shipment/index.md)
- [ShoppingCartV2 schema](https://developers.firmly.ai/resources/schemas/shopping-cart/index.md)
## Solutions
- [AI Deal & Coupon Hunting](https://developers.firmly.ai/solutions/agentic-commerce/use-cases/deal-coupon-hunting/index.md)
- [AI Shopping Copilot](https://developers.firmly.ai/solutions/agentic-commerce/use-cases/shopping-copilot/index.md)
- [AI surfaces](https://developers.firmly.ai/solutions/destination-surfaces/ai-surfaces/index.md)
- [Ad Commerce](https://developers.firmly.ai/solutions/ad-commerce/index.md)
- [Ads](https://developers.firmly.ai/solutions/destination-surfaces/ads/index.md)
- [Agentic Commerce FAQ](https://developers.firmly.ai/solutions/agentic-commerce/faq/index.md)
- [Agentic Commerce](https://developers.firmly.ai/solutions/agentic-commerce/index.md)
- [Agentic Pay Integration](https://developers.firmly.ai/solutions/agentic-commerce/agentic-pay-integration/index.md)
- [Agentic Pay](https://developers.firmly.ai/solutions/agentic-commerce/agentic-pay/index.md)
- [Agreement signing](https://developers.firmly.ai/solutions/firmly-connect/onboarding/agreement-signing/index.md)
- [Audit logs](https://developers.firmly.ai/solutions/firmly-connect/portal/audit-logs/index.md)
- [Autonomous Agent Purchasing](https://developers.firmly.ai/solutions/agentic-commerce/use-cases/autonomous-agent-purchasing/index.md)
- [Branded Commerce FAQ](https://developers.firmly.ai/solutions/branded-commerce/faq/index.md)
- [Branded Commerce](https://developers.firmly.ai/solutions/branded-commerce/index.md)
- [Branded Marketplace](https://developers.firmly.ai/solutions/marketplace/use-cases/branded-marketplace/index.md)
- [Buyer Purchase Flow](https://developers.firmly.ai/solutions/branded-commerce/flows/buyer-purchase-flow/index.md)
- [CDN whitelisting](https://developers.firmly.ai/solutions/firmly-connect/onboarding/cdn-whitelisting/index.md)
- [Catalog configuration](https://developers.firmly.ai/solutions/firmly-connect/onboarding/catalog-configuration/index.md)
- [Chat to Checkout](https://developers.firmly.ai/solutions/agentic-commerce/recipes/chat-to-checkout/index.md)
- [Connected TV](https://developers.firmly.ai/solutions/destination-surfaces/ctv/index.md)
- [Consent & Disclosure](https://developers.firmly.ai/solutions/agentic-commerce/consent-and-disclosure/index.md)
- [Curated Landing Page](https://developers.firmly.ai/solutions/branded-commerce/use-cases/curated-landing-page/index.md)
- [Curated Product Roundup](https://developers.firmly.ai/solutions/publisher-commerce/use-cases/curated-product-roundup/index.md)
- [Dashboard](https://developers.firmly.ai/solutions/branded-commerce/operations/dashboard/index.md)
- [Dedicated Landing](https://developers.firmly.ai/solutions/publisher-commerce/integration-patterns/dedicated-landing/index.md)
- [Deep Link / Headless](https://developers.firmly.ai/solutions/agentic-commerce/integration-patterns/deep-link/index.md)
- [Destination surfaces](https://developers.firmly.ai/solutions/destination-surfaces/index.md)
- [Destinations configuration](https://developers.firmly.ai/solutions/firmly-connect/onboarding/destinations-configuration/index.md)
- [Domains and SSO](https://developers.firmly.ai/solutions/firmly-connect/portal/domains-and-sso/index.md)
- [Embedded Buy Button](https://developers.firmly.ai/solutions/publisher-commerce/integration-patterns/embedded-buy-button/index.md)
- [Embedded Checkout](https://developers.firmly.ai/solutions/agentic-commerce/integration-patterns/embedded-checkout/index.md)
- [Embedded Marketplace](https://developers.firmly.ai/solutions/marketplace/integration-patterns/embedded-marketplace/index.md)
- [Errors](https://developers.firmly.ai/solutions/agentic-commerce/operations/errors/index.md)
- [Firmly Card UCP Handler](https://developers.firmly.ai/solutions/agentic-commerce/protocols/ucp/firmly-card-handler/index.md)
- [Firmly Connect](https://developers.firmly.ai/solutions/firmly-connect/index.md)
- [Flows](https://developers.firmly.ai/solutions/ad-commerce/flows/index.md)
- [Flows](https://developers.firmly.ai/solutions/agentic-commerce/flows/index.md)
- [Flows](https://developers.firmly.ai/solutions/branded-commerce/flows/index.md)
- [Flows](https://developers.firmly.ai/solutions/marketplace/flows/index.md)
- [Flows](https://developers.firmly.ai/solutions/publisher-commerce/flows/index.md)
- [Generic OIDC](https://developers.firmly.ai/solutions/firmly-connect/sso/generic-oidc/index.md)
- [Generic SAML 2.0](https://developers.firmly.ai/solutions/firmly-connect/sso/generic-saml/index.md)
- [Going Live](https://developers.firmly.ai/solutions/agentic-commerce/operations/going-live/index.md)
- [Hosted Checkout](https://developers.firmly.ai/solutions/agentic-commerce/integration-patterns/hosted-checkout/index.md)
- [How JavaScript injection works](https://developers.firmly.ai/solutions/social-commerce/js-injection/index.md)
- [Idempotency](https://developers.firmly.ai/solutions/agentic-commerce/protocols/ucp/idempotency/index.md)
- [In-Ad Checkout](https://developers.firmly.ai/solutions/ad-commerce/integration-patterns/in-ad-checkout/index.md)
- [In-Feed Shoppable Ad](https://developers.firmly.ai/solutions/ad-commerce/use-cRead the complete saved Markdown as plain text →
Measured from the saved file
Linked document
UTF-8 text size 25.4 KB26019 bytes
Token count 6302o200k_base encoding
Markdown links 251251 distinct URLs
Fenced code blocks 0290 lines in the file Size measures the captured UTF-8 text, not compressed transfer size. Tokens are counted with a named tokenizer; other models can count differently. Neither measure establishes context compatibility or answer quality.
Project H1 Firmly Docs
Context architecture
How the content is divided 12 H2 sections organize 251 parsed Markdown links. 249 links point to .md or .markdown paths; 0 link occurrences use another hostname. Linked destinations have not been recursively validated.
H2 section Links UTF-8 bytes Tokens GeneralLine 5 2 409 91 API ReferenceLine 10 85 8453 1963 Contact usLine 98 1 64 17 CookbookLine 102 7 689 176 FAQLine 112 1 53 17 For DestinationsLine 116 7 617 161 For MerchantsLine 126 7 632 161 FoundationsLine 136 4 326 83 How Firmly WorksLine 143 1 79 24 ResourcesLine 147 13 1132 269 SolutionsLine 163 118 12621 3124 TroubleshootingLine 284 5 462 117
Link counts exclude parsed fenced and inline code and resolve relative destinations against the final endpoint. Section sizes cover the text below each H2 until the next H2.
Embedded material
Code, installation and API examples Fenced blocks 0 closed Declared languages No fenced blocks detected Package-install commands 0 detected in fenced or inline code Authentication examples 0 fenced lines match API-key, Authorization, Bearer, OAuth or access-token patterns HTTP request examples 0 fenced lines match request-method patterns Authentication links 0 links have authentication-related labels Embedded example text and links to further documentation are counted separately. A code block does not establish that a sample runs or that an authentication flow succeeds.
Publisher prioritization
The Optional section No H2 section named “Optional” was detected in this file.
The community proposal uses Optional by convention for secondary links that can be skipped for a shorter context. This label does not establish that everything outside it is critical, or that the material inside it is deprecated.
Machine-readable routes
MCP references and configuration text No MCP or Model Context Protocol term was detected in the captured file. 0 links have MCP-related labels or paths. 0 fenced lines match mcpServers, mcp_servers or an mcp add command.
These are text and link observations. No MCP server connection, authentication or tool call was tested.
Index and bundle
llms-full.txt companion Verified text companion
Text companion verified https://developers.firmly.ai/llms-full.txt ↗ Discovery Conventional sibling path checked HTTP response 200 · text/plain Text size 1.5 MB · 1521814 bytes (measured) Token count 364387 o200k_base tokens Retrieval scope Complete body retrieved A verified text response establishes a companion at the checked URL. It does not prove the bundle contains all product documentation, that generation is automated, or that it fits an assistant’s context window.
Change evidence
What can be said about freshness This capture establishes a baseline. Update frequency cannot be determined from one observation.
Linked release and migration material 1 links have release, changelog, deprecation or migration terms in their labels or paths. These provide places to investigate product changes separately.
File changes can reveal documentation edits or navigation changes. They do not by themselves measure product release velocity, accuracy, agent adoption or AI visibility.
Capture identity and measurement method Requested endpoint https://docs.firmly.ai/llms.txt Final endpoint https://developers.firmly.ai/llms.txt HTTP status 200 Content type text/plain Text retrieval Firecrawl literal text capture Tokenizer tiktoken 0.14.0 · o200k_base SHA-256 of saved UTF-8 text a22b1e36ecda92c420e3679caeb09de226de5186b4dd6a7f634a31630056c3deCounts use a deterministic parser, not a spec-compliance grade. Unusual Markdown and indented code can fall outside its recognized patterns. See the llms.txt proposal and tokenizer implementation .