# api

## Pages

- [FirearmCart API](https://docs.firearmcart.com/api/index.md) — REST API reference for the FirearmCart v1 sales platform API
- [Authentication](https://docs.firearmcart.com/api/authentication/index.md) — Bearer tokens, the team-owned token model, abilities, and the API access gate
- [Conventions](https://docs.firearmcart.com/api/conventions/index.md) — The two identifier kinds and the mixed money units, resource by resource
- [Errors](https://docs.firearmcart.com/api/errors/index.md) — The error envelopes the API actually returns, per status code
- [Theme Dev MCP server](https://docs.firearmcart.com/api/mcp/index.md) — Connect an AI client to the FirearmCart theme development MCP server — transport, tokens, abilities, and team scoping
- [Resources & prompts](https://docs.firearmcart.com/api/mcp/resources/index.md) — The three MCP resources and two prompts the Theme Dev server ships, and when an agent should reach for each
- [Tools](https://docs.firearmcart.com/api/mcp/tools/index.md) — All 33 tools the Theme Dev MCP server exposes — arguments, guardrails, and which ability each one needs
- [Pagination](https://docs.firearmcart.com/api/pagination/index.md) — The data / links / meta envelope, per_page, and the endpoints that do not paginate
- [Rate limits](https://docs.firearmcart.com/api/rate-limits/index.md) — Per-store request budgets, rate limit headers, and the 429 response
- [Customers & leads](https://docs.firearmcart.com/api/resources/customers/index.md) — Read the customers on your store and upsert leads by email address.
- [Fulfillments](https://docs.firearmcart.com/api/resources/fulfillments/index.md) — Read the shipment groups behind an order, with carrier tracking and a full status timeline
- [Orders](https://docs.firearmcart.com/api/resources/orders/index.md) — Read a store's orders and charge post-purchase add-ons against an order that has already been paid.
- [Payments](https://docs.firearmcart.com/api/resources/payments/index.md) — Tokenize a card in a hosted iframe, then charge it and create the order in one call.
- [Products](https://docs.firearmcart.com/api/resources/products/index.md) — Read your catalog through the API — products, variants, images and specifications
- [Shipping, taxation & FFL dealers](https://docs.firearmcart.com/api/resources/shipping-taxation-ffl/index.md) — Read shipping zones and rates, manual tax zones, and the ATF FFL dealer directory.
- [Subscriptions](https://docs.firearmcart.com/api/resources/subscriptions/index.md) — Read and manage Reload recurring orders — reschedule, pause, resume, skip and cancel
- [Webhooks](https://docs.firearmcart.com/api/webhooks/index.md) — Consuming outgoing webhooks — payload shape, verification, and retry behaviour