FluentCart REST API
The full REST API reference for FluentCart. Orders, products, customers, subscriptions — everything your store needs, served as clean JSON.
The FluentCart REST API gives you programmatic access to your entire store. Orders, products, customers, subscriptions, coupons, shipping, tax — it's all here, patiently waiting for your HTTP requests.
Built on the WordPress REST API, every endpoint lives under the fluent-cart/v2 namespace. You authenticate with standard WordPress methods, get JSON back, and carry on with your life. No surprises, no drama.
Base URL
https://your-site.com/wp-json/fluent-cart/v2/Replace your-site.com with whatever domain your WordPress lives on. All endpoints in this reference are relative to this base URL.
Authentication
FluentCart piggybacks on WordPress authentication — because why reinvent the wheel when there's a perfectly good one rolling already. The simplest approach for server-to-server calls is application passwords (WordPress 5.6+). Pass your credentials via the Authorization header:
curl -X GET "https://your-site.com/wp-json/fluent-cart/v2/orders" \
-H "Authorization: Basic base64(username:application_password)"All API requests require an authenticated user with appropriate capabilities. No auth, no data — refreshingly unambiguous.
Endpoint Groups
Orders
Create, retrieve, update, and manage orders. Includes line items, addresses, transactions, and status changes.
Products
Full product lifecycle management. Pricing plans, variations, downloads, and product metadata.
Customers
Customer records, addresses, purchase history, and account details.
Subscriptions
Recurring billing management. View, cancel, pause, and modify active subscriptions.
Coupons
Discount code management. Create percentage or fixed-amount coupons with usage limits and expiry dates.
Shipping
Shipping zones, methods, and rate configuration.
Tax
Tax classes, rates, and regional tax configuration.
Reports
Revenue, order, and product analytics. Date-filtered reporting endpoints.
Settings
Store configuration, payment gateways, email settings, and general preferences.
Email Notifications
Email template management and notification configuration.
Integrations
Third-party integration feeds and webhook configuration.
Files & Storage
File upload, download management, and digital product delivery.
Licensing
Software licence key management, activations, and validation.
Roles & Permissions
User capability management for FluentCart admin access.
Dashboard
Store overview statistics and quick-glance metrics.
OpenAPI Specification
The full API is documented using the OpenAPI 3.0 specification. Each endpoint page in this section is auto-generated from the spec — request parameters, response schemas, and an interactive playground for testing against your own store. I didn't write all this by hand, I'm not a masochist.
Work in Progress
This API reference is generated from a live FluentCart instance. I'm expanding endpoint coverage as I document more of the API surface. If something's missing, it's probably next on the list.