Skip to content

Access and formats

https://suly.gg/api/partner/v1

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.
  • JSON in and out. Every POST sends Content-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.

Lists return 50 items per page, newest first:

{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }

Ask for the next page with ?page=2.

Sequential requests are enough for any integration. If you receive 429 or 503, wait and repeat the request later.