Skip to content

Errors

An error is an HTTP status with a JSON body:

{ "code": "INVALID_INPUT", "messageKey": "…", "retryable": false, "correlationId": "…" }
  • code is stable: build your logic on it.
  • retryable: true means the same request can be sent again later.
  • Log code and correlationId (never the key) and include the correlationId when you write to support.
Status Code When What to do
400 INVALID_INPUT A wrong request, field or unknown parameter Fix the request; do not repeat it as is
401 NOT_AUTHENTICATED No key, a wrong key, or the key was replaced Stop and check the key
403 FORBIDDEN The business account is banned on suly.gg Stop and contact support
404 NOT_FOUND No such participant in this offer, or an unknown address Check the id and the path
409 OFFER_ENDED The offer is closed: codes and accruals are no longer taken Stop the jobs; reading still works
409 PARTICIPANT_NOT_ACTIVE An accrual for a creator without a code, or declined Send a code first
409 CREATOR_BANNED The creator is banned on suly.gg Do not pay
409 INSUFFICIENT_BUDGET The budget is less than the amount plus the fee Add budget to the offer, then repeat
409 EXTERNAL_ID_CONFLICT This externalId was used with other data Investigate; never overwrite
429 (rate limit) Too many requests Repeat later with a pause
503 DEPENDENCY_UNAVAILABLE A temporary error Repeat the same request later