API Reference
The Suger API for cloud marketplace automation.
Build integrations that automate the full marketplace lifecycle — listings, private offers, agreements, metering, and revenue reporting — from a single REST API.
/v1/offers /v1/offers /v1/agreements /v1/metering /v1/reports Access every marketplace workflow programmatically
Create offers, manage agreements, submit usage data, and generate reports — all through consistent REST endpoints.
Fast & reliable
99.9% uptime SLA with sub-100ms response times
Secure by default
OAuth 2.0 authentication with fine-grained permissions
RESTful design
Consistent, predictable patterns across all endpoints
Rate limiting
Generous rate limits with clear headers and retry guidance
Make your first API call in seconds
curl -X GET "https://api.suger.io/v1/offers" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"API questions, answered
What is the Suger API? +
The Suger API is a REST API for automating cloud marketplace operations — creating private offers, managing agreements, submitting metering records, and generating reports across AWS, Azure, GCP, and Snowflake marketplaces.
How do I authenticate with the Suger API? +
Suger uses OAuth 2.0 with bearer tokens. Generate an API key from your Suger console, then include it in the Authorization header: `Authorization: Bearer YOUR_API_KEY`.
What is the API base URL? +
The production base URL is https://api.suger.io. All endpoints are versioned under /v1/ — for example, https://api.suger.io/v1/offers.
What are the API rate limits? +
Default rate limits are 100 requests per second per API key with a burst of 200. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are returned on every response. Contact sales for higher limits.
Does Suger offer SDKs? +
Yes. Official SDKs are available for Node.js, Python, Go, and Java. See the SDKs page for installation instructions and code samples.
Are webhooks supported? +
Yes. Suger sends signed webhooks for offer acceptance, agreement updates, and disbursement events. All payloads are HMAC-signed with your webhook secret for verification.
Ready to build with Suger?
Get your API keys and start automating your cloud marketplace workflow today.