SUQO External API
Public, API-key-authenticated endpoints for third-party consumers. Use the API to read your products, create and manage subscriptions, and list your customers directly from your own software.
Base URLs
Every endpoint lives under the base path /api/v1/. Pick the environment you're targeting:
| Environment | Base URL |
|---|---|
| Live | https://be.suqo.ai |
| Sandbox | https://test-be.suqo.ai |
So a full request URL looks like:
https://be.suqo.ai/api/v1/products/Build and test against the Sandbox first — no checkout SMS and no real money. Email is the exception: it is delivered for real even in the sandbox.
Authentication
All endpoints authenticate with a bearer API key. Generate one in the API Integration section of the seller dashboard, then send it in the Authorization header:
Authorization: Bearer <api_key>See Authentication for auth errors.
Resources
| Resource | What it does |
|---|---|
| Products | List your active products with plans, billing periods, and VAT config. |
| Subscriptions | List, create, cancel, and set the billing cycle of subscriptions. |
| Customers | List and retrieve your customers. |
| Webhooks | Receive signed event notifications instead of polling. |
Trailing slash required. Every route ends in
/. A GET without it 301-redirects; a POST without it fails, because the redirect can't preserve the body. See Errors & Pagination.