Access and formats
Base URL
Section titled “Base URL”https://suly.gg/api/partner/v1The key
Section titled “The key”Every request carries the header:
Authorization: Bearer suly_…- The key looks like
suly_followed by 43 characters (48 in total). - You create it on the offer page in the business cabinet, in the API key block, once the offer is approved. Each offer has its own key.
- It is shown only once. Replace key issues a new one, and the old key stops working at once (
401). - Keep it secret: store it in an environment variable or a secret store, never in code, logs or a browser.
Requests and answers
Section titled “Requests and answers”- JSON in and out. Every
POSTsendsContent-Type: application/json. - Unknown fields and unknown query parameters are refused with
400 INVALID_INPUT. - Times are ISO 8601 in UTC:
2026-11-03T10:00:00.000Z.
Money is a string in US dollars with a dot and at most six decimals: "12.5", "0.01". Answers always have six decimals: "12.500000". Never send money as a JSON number.
Paging
Section titled “Paging”Lists return 50 items per page, newest first:
{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }Ask for the next page with ?page=2.
Limits
Section titled “Limits”Sequential requests are enough for any integration. If you receive 429 or 503, wait and repeat the request later.