Skip to content

Guides

Errors

Error responses and what they mean.

Errors return an HTTP status code and a JSON body with a machine-readable code and a readable message:

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid query parameters.",
    "details": [
      {
        "path": "rarity",
        "message": "Too big: expected number to be <=3"
      }
    ]
  }
}

details is included when there is more to say, such as which parameters failed validation.

Status code Meaning
400 INVALID_REQUEST Parameters or body are invalid, such as a missing field, an unknown field, a wrong type or a malformed id.
401 UNAUTHORIZED The API key is missing, invalid or revoked.
403 FORBIDDEN The key is valid but can't do this.
404 NOT_FOUND The resource doesn't exist, or it isn't yours.
409 CONFLICT The change clashes with existing data, such as a duplicate friend code.
429 RATE_LIMITED You sent too many requests. Wait for the number of seconds in the Retry-After header. See Usage limits.
500 INTERNAL_ERROR Something went wrong on our side. Try again later.

Request bodies are validated strictly: unknown fields are rejected with 400, not ignored.

Joe's Blue Archive Tools API · exported Nov 1, 2026

llms.txtBuilt with yaakdoc