Skip to main content
When something goes wrong, the API returns a non-2xx status and a consistent JSON envelope with a machine-readable code you can branch on: 
{
  "error": {
    "code": "not_found",
    "message": "Script not found.",
    "details": { }
  }
}
message is human-readable and may change; code is stable — switch on it, not on the message text. details is optional and only present when it helps (for example, marketplaceUrl on a paid-script 402).

​
Status codes

StatuscodeWhen
400bad_requestA parameter is malformed (bad enum, non-numeric placeId, etc.)
401unauthorizedReserved; the public API does not require auth
402payment_requiredRaw source requested for a paid script — see details.marketplaceUrl
403forbiddenRaw source requested for a key-system script — see details.keyLink
404not_foundNo such script, game, creator, or endpoint
405method_not_allowedWrong HTTP method for the endpoint
429rate_limitedRate limit exceeded — honour Retry-After
503unavailableTemporary upstream issue — retry after a short delay

​
Validation errors

Unknown query parameters are ignored (so we can add new ones without breaking you), but malformed known parameters return 400 with a clear message: 
{ "error": { "code": "bad_request", "message": "'sortBy' must be one of: views, likeCount, dislikeCount, createdAt, updatedAt, score, accuracy" } }

​
Raw-source gating

The /raw endpoint only serves source for free, keyless scripts. Otherwise: 
{
  "error": {
    "code": "payment_required",
    "message": "This is a paid script; source is not available via the API.",
    "details": { "marketplaceUrl": "https://…" }
  }
}
You can avoid these entirely: a script object only includes a rawUrl when its source is actually servable. Check rawUrl != null (or scriptType === "free" && key === false) before fetching raw.