Skip to content
J·BJon BishopFractional growth marketer

Artificial intelligence · llms.txt file breakdown

Firmly llms.txt

A directly retrieved Markdown index for Firmly's documentation, with 251 links across 5 detected headings.

The actual file

Source Markdown

The saved llms.txt text, displayed as source. The file belongs to its publisher; the live endpoint may change.

Open saved text ↗

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-c

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 sectionLinksUTF-8 bytesTokens
GeneralLine 5240991
API ReferenceLine 108584531963
Contact usLine 9816417
CookbookLine 1027689176
FAQLine 11215317
For DestinationsLine 1167617161
For MerchantsLine 1267632161
FoundationsLine 136432683
How Firmly WorksLine 14317924
ResourcesLine 147131132269
SolutionsLine 163118126213124
TroubleshootingLine 2845462117

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
a22b1e36ecda92c420e3679caeb09de226de5186b4dd6a7f634a31630056c3de

Counts 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.

Related tools and resources

Contact Jon