For AI agents: the documentation index is at https://api.hlplanet.com/llms.txt. This page is also available as Markdown at https://api.hlplanet.com/docs/errors.md.

HLPlanet Keyboard APIKeyboard sizesMeasured keyboardsCompare keyboardsDesk fitFind a keyTesting toolsMCP serverErrorsOpenAPI

Errors

Every error returns a non-2xx status and the same JSON shape:

{
  "error": {
    "code": "unknown_keyboard",
    "message": "Unknown keyboard or size \"banana\". Use a size (100%, 98%, TKL, 75%, 65%, 60%) or one of these keyboards: …"
  }
}
StatuscodeWhen
400missing_parameterA required query parameter is missing
400invalid_parameterA parameter is out of range or not one of the allowed values
400unknown_keyboardAn item is neither a size nor a known keyboard
400unknown_sizeThe size filter is not a known size
404unknown_size, unknown_keyboard, unknown_keyThe path names something that doesn't exist
404not_foundNo such endpoint
405method_not_allowedOnly GET, HEAD and OPTIONS are supported

Messages are written for people and can change; match on code.