Errors
An error is an HTTP status with a JSON body:
{ "code": "INVALID_INPUT", "messageKey": "…", "retryable": false, "correlationId": "…" }codeis stable: build your logic on it.retryable: truemeans the same request can be sent again later.- Log
codeandcorrelationId(never the key) and include thecorrelationIdwhen 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 |