.. This file is part of Beekeeper. Copyright (C) 2026 Taler Systems SA Beekeeper is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1, or (at your option) any later version. Beekeeper is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with Beekeeper; see the file COPYING. If not, see SPDX-License-Identifier: LGPL3.0-or-later Note: the LGPL does not apply to all components of Beekeeper, but it does apply to this file. .. _beekeeper-error-codes: Beekeeper Error Codes --------------------- Codes in the range 100000 to 110000, returned by Beekeeper next to the generic codes of the GNU Taler registry. .. list-table:: :header-rows: 1 * - Value - Name - HTTP status - Description * - 100000 - BEEKEEPER_RATE_LIMITED - 429 - Too many requests of this kind from this client. Retry after the time given in the Retry-After header. * - 100001 - BEEKEEPER_PROOF_OF_WORK_INVALID - 403 - The server requires a proof of work for this request, and it was missing, wrong or expired. Fetch a new puzzle and retry. * - 100100 - BEEKEEPER_ACCESS_TOKEN_UNKNOWN - 401 - The access token of the personal link is unknown or was revoked, for example because a new link was issued. * - 100101 - BEEKEEPER_SESSION_INVALID - 401 - The session token is missing, expired or revoked. Create a new session. * - 100102 - BEEKEEPER_OTP_WRONG - 403 - The one-time code is wrong. * - 100103 - BEEKEEPER_OTP_EXPIRED - 409 - The one-time code has expired or has no attempts left. Request a new one. * - 100104 - BEEKEEPER_ADMIN_LOGIN_FAILED - 401 - The user name, password or TOTP code is wrong. * - 100105 - BEEKEEPER_ADMIN_ROLE_MISSING - 403 - The administrator account lacks the role required for this request. * - 100200 - BEEKEEPER_FORM_UNKNOWN - 404 - There is no such form, or it is not public. * - 100201 - BEEKEEPER_FORM_INVALID - 400 - The form definition failed the static checks. The problems are listed per JSON path. * - 100202 - BEEKEEPER_FORM_RETIRED - 409 - The form was retired and can no longer be assigned or started. * - 100300 - BEEKEEPER_ASSIGNMENT_UNKNOWN - 404 - There is no such assignment for this user. * - 100301 - BEEKEEPER_ASSIGNMENT_STATE - 409 - The request is not allowed in the current state of the assignment. * - 100302 - BEEKEEPER_ASSIGNMENT_INCOMPLETE - 400 - The assignment cannot be submitted because some visible pages do not pass their checks. * - 100303 - BEEKEEPER_PAGE_UNKNOWN - 404 - The form has no page with this identifier. * - 100304 - BEEKEEPER_PAGE_HIDDEN - 409 - The page is not visible with the current answers. * - 100305 - BEEKEEPER_PAGE_INVALID - 400 - The answers were saved as a draft, but the page did not pass its checks. The problems are listed per question. * - 100306 - BEEKEEPER_QUESTION_UNKNOWN - 404 - There is no such question on this page, or it does not support the requested operation. * - 100307 - BEEKEEPER_USER_UNKNOWN - 404 - There is no such user. * - 100400 - BEEKEEPER_VERIFICATION_WRONG_CODE - 403 - The verification code is wrong. * - 100401 - BEEKEEPER_VERIFICATION_RATE_LIMITED - 429 - Verification codes were requested too often for this user or address. * - 100402 - BEEKEEPER_VERIFICATION_NOT_STARTED - 409 - No verification code was sent for the current answer, or it has expired. * - 100403 - BEEKEEPER_HELPER_FAILED - 502 - The helper program that delivers e-mail, SMS or letters failed. * - 100500 - BEEKEEPER_CHALLENGE_EXPIRED - 409 - The recording answers a video challenge that has expired or was replaced by a newer one. * - 100501 - BEEKEEPER_BLOB_UNKNOWN - 400 - An answer refers to a file that this user has not uploaded. * - 100502 - BEEKEEPER_BLOB_NOT_FOUND - 404 - There is no such file. * - 100503 - BEEKEEPER_UPLOAD_TOO_LARGE - 413 - The upload is larger than the question or the server allows. * - 100504 - BEEKEEPER_UPLOAD_TYPE - 415 - The question does not accept files of this MIME type. * - 100505 - BEEKEEPER_UPLOAD_UNKNOWN - 404 - There is no such upload, or it has expired. * - 100506 - BEEKEEPER_UPLOAD_OFFSET_MISMATCH - 409 - The Upload-Offset of the request does not match the length received so far. * - 100507 - BEEKEEPER_UPLOAD_CHECKSUM_MISMATCH - 409 - The SHA-256 of the complete upload differs from the announced one, and the upload was discarded. The tus endpoint answers with its status 460 (Checksum Mismatch), which the HTTP status registry does not list. * - 100508 - BEEKEEPER_SUBTITLES_INVALID - 400 - The subtitles of a challenge recording are not a well-formed SRT file, or their cues do not match the actions, order, timing and instructions of the challenge. * - 100600 - BEEKEEPER_OAUTH_CLIENT_UNKNOWN - 401 - The OAuth2 client is unknown or disabled, or its secret is wrong. * - 100601 - BEEKEEPER_OAUTH_PROCESS_UNKNOWN - 404 - There is no such KYC process, or it has expired. * - 100602 - BEEKEEPER_OAUTH_REQUEST_INVALID - 400 - The authorization request does not match the client: wrong client_id, redirect_uri or response_type. * - 100603 - BEEKEEPER_OAUTH_CODE_INVALID - 403 - The authorization code is unknown, expired or was already used. * - 100604 - BEEKEEPER_OAUTH_TOKEN_INVALID - 401 - The access token is unknown or expired. * - 100605 - BEEKEEPER_OAUTH_NOT_READY - 409 - The KYC process is not finished yet: some assignments are neither accepted nor failed.