Skip to main content

Response Codes

Every endpoint answers with the same wrapper, where code is a stable string a client can branch on. The HTTP status says whether the call succeeded; the code says why, and stays the same across releases even when the human-readable message changes.

{
"code": "AT-405",
"message": "attempt already submitted",
"data": null
}
tip

Branch on code, never on message. Messages are for humans and may be reworded at any time.

This page covers 65 codes across 111 endpoints. Search for a code (for example AT-405) to jump straight to its entry.

Code prefixes​

PrefixDomain
0000Generic success
AC-Autocomplete
AI-AI question generation
AK-API keys
AN-Analytics
AT-Attempts
AUTH-Authentication
DS-Infrastructure
EV-Events
LB-Leaderboard
LC-Licensing
PT-Participants
QI-Quiz / question info
QS-Questions
QTS-Question templates
QZ-Quizzes
SC-Scoring
TK-Tickets
U-Users
VAL-Request validation

All codes​

CodeHTTPMeaningDomain
0000200 OK, 201 Created, 204 No ContentOkAll domains
AI-001400 Bad RequestConfig errorAI question generation
AI-002400 Bad RequestGeneration failedAI question generation
AT-003200 OKAttempt retrievedAttempts
AT-004200 OKTransfer will auto closeAttempts
AT-099200 OKAttempt finishedAttempts
AT-101400 Bad RequestAttempt create failedAttempts
AT-102400 Bad RequestAnswer submit failedAttempts
AT-401400 Bad RequestUnauthorizedAttempts
AT-402400 Bad RequestInvalid access codeAttempts
AT-404400 Bad RequestNot foundAttempts
AT-405400 Bad RequestAlready submittedAttempts
AT-406400 Bad RequestQuiz not foundAttempts
AT-407400 Bad RequestQuiz not availableAttempts
AT-408400 Bad RequestInvalid attempt stateAttempts
AT-409400 Bad RequestTime limit exceededAttempts
AT-410400 Bad RequestMax attempts reachedAttempts
AT-411400 Bad RequestEvent not foundAttempts
AT-412400 Bad RequestEvent not activeAttempts
AT-413400 Bad RequestEvent max attempts reachedAttempts
AT-414400 Bad RequestEvent endedAttempts
AT-415400 Bad RequestClient requiredAttempts
AT-416400 Bad RequestAn owner closed the attempt out from under the participantAttempts
AT-417400 Bad RequestThe attempt ran out of time and was closed by the auto-submit workerAttempts
AT-429429 Too Many RequestsQuota exceededAI question generation, Attempts
AT-501400 Bad RequestTransfer source not foundAttempts
AT-502400 Bad RequestTransfer open successor existsAttempts
AT-503400 Bad RequestForce submit source not foundAttempts
AT-504400 Bad RequestTransfer question count changedAttempts
AT-603429 Too Many RequestsFlag cap exceededAttempts
AUTH-001400 Bad RequestUnauthorizedAll domains
AUTH-101400 Bad RequestInvalid credentialsAuthentication
AUTH-102400 Bad RequestToken creation failedAuthentication
AUTH-103400 Bad RequestRegistration disabledAuthentication
AUTH-104400 Bad RequestProvider disabledAuthentication
AUTH-201400 Bad RequestInvalid refresh tokenAuthentication
AUTH-202400 Bad RequestToken creation failedAuthentication
AUTH-301400 Bad RequestProvider disabledOAuth
AUTH-302400 Bad RequestInvalid provider tokenOAuth
AUTH-303400 Bad RequestInvalid oauth headerOAuth
AUTH-304400 Bad RequestUser create failedOAuth
AUTH-305400 Bad RequestToken creation failedOAuth
DS-000400 Bad RequestInfrastructure errorAll domains
EV-404400 Bad RequestNot foundEvents
EV-405400 Bad RequestQuiz state invalidEvents
LB-404400 Bad RequestUnauthorizedQuiz info
PT-101400 Bad RequestCreate failedParticipants
PT-102400 Bad RequestUpdate failedParticipants
PT-103400 Bad RequestDelete failedParticipants
PT-404404 Not FoundNot foundParticipants
PT-409409External id conflictParticipants
QI-400400 Bad RequestBad requestQuiz info
QI-404400 Bad RequestUnauthorizedQuiz info
QS-101400 Bad RequestQuestion create failedQuestions
QS-404400 Bad RequestNot foundQuestions
QTS-101400 Bad RequestTemplate create failedQuestion templates
QTS-404400 Bad RequestNot foundQuestion templates
QZ-101400 Bad RequestQuiz create failedQuizzes (write)
QZ-404400 Bad RequestNot foundQuizzes (read), Quizzes (write)
TK-404400 Bad RequestNot foundTickets
TK-405400 Bad RequestInvalid scopeTickets
U-111400 Bad RequestPassword hash failedAuthentication
U-112400 Bad RequestUser create failedAuthentication
VAL-001400 Bad RequestInvalid inputAll domains
VAL-002400 Bad RequestInvalid paramsAll domains

Shared codes​

Returned by endpoints in every domain.

0000 — Ok​

  • Type: Success
  • HTTP status: 200 OK, 201 Created, 204 No Content
  • Returned by: DELETE /api/v1/participants/{id}, DELETE /api/v1/question-templates/{id}, DELETE /api/v1/questions/{id}, DELETE /api/v1/tickets/{ticket_id}, GET /api/v1/analytics/events/compare, GET /api/v1/analytics/events/{event_id}/stats, GET /api/v1/analytics/events/{event_id}/timeline, GET /api/v1/analytics/participants/{participant_id}/quizzes/{quiz_id}/report, GET /api/v1/analytics/participants/{participant_id}/report, GET /api/v1/analytics/questions/{question_id}/stats, GET /api/v1/analytics/quizzes/{quiz_id}/participants, GET /api/v1/analytics/quizzes/{quiz_id}/performance, and 94 more

AUTH-001 — Unauthorized​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/questions/{id}, GET /api/v1/questions/{id}/client, GET /api/v1/questions/{id}/public, GET /api/v1/questions/{id}, PATCH /api/v1/questions/{id}/metadata/ops, POST /api/v1/quizzes/evaluate-answer, PUT /api/v1/questions/{id}

DS-000 — Infrastructure error​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/events/{event_id}, DELETE /api/v1/question-templates/{id}, DELETE /api/v1/tickets/{ticket_id}, GET /api/v1/attempts/{session_token}, GET /api/v1/events/{event_id}, GET /api/v1/info/attempts/{attempt_id}/answers, GET /api/v1/info/attempts/{attempt_id}/flags, GET /api/v1/info/attempts, GET /api/v1/info/quizezz/leaderboard/{quiz_id}/public, GET /api/v1/info/quizezz/leaderboard/{quiz_id}, GET /api/v1/info/quizezz/participant/{quiz_id}, GET /api/v1/info/quizezz/participated/{quiz_id}, and 48 more

VAL-001 — Invalid input​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/analytics/events/compare, GET /api/v1/analytics/events/{event_id}/timeline, GET /api/v1/analytics/quizzes/{quiz_id}/participants, GET /api/v1/analytics/quizzes/{quiz_id}/performance, GET /api/v1/analytics/trends/overview, GET /api/v1/analytics/trends/top-quizzes, GET /api/v1/quizzes/public, GET /api/v1/quizzes, GET /api/v1/tickets, PATCH /api/v1/events/{event_id}/metadata/ops, PATCH /api/v1/question-templates/{id}/metadata/ops, PATCH /api/v1/questions/{id}/metadata/ops, and 30 more

VAL-002 — Invalid params​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/question-templates/mine, GET /api/v1/question-templates/public, GET /api/v1/question-templates, GET /api/v1/questions

Codes by domain

AI question generation​

AI-001 — Config error​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/questions/generate

AI-002 — Generation failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/questions/generate

AT-429 — Quota exceeded​

  • Type: Error
  • HTTP status: 429 Too Many Requests
  • Returned by: POST /api/v1/attempts/{session_token}/answers, POST /api/v1/attempts/{session_token}/submit, POST /api/v1/attempts, POST /api/v1/members/attempts, POST /api/v1/questions/generate

Attempts​

AT-003 — Attempt retrieved​

  • Type: Success
  • HTTP status: 200 OK
  • Returned by: GET /api/v1/attempts/{session_token}

AT-004 — Transfer will auto close​

Same-event transfer succeeded, but the event has already ended so the successor will be closed by the auto-submission collector.

  • Type: Success
  • HTTP status: 200 OK
  • Returned by: POST /api/v1/attempts/{attempt_id}/transfer

AT-099 — Attempt finished​

  • Type: Success
  • HTTP status: 200 OK
  • Returned by: GET /api/v1/attempts/{session_token}

AT-101 — Attempt create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts

AT-102 — Answer submit failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{session_token}/answers

AT-401 — Unauthorized​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/members/attempts

AT-402 — Invalid access code​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts

AT-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{session_token}/flags

AT-405 — Already submitted​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/force-submit, POST /api/v1/attempts/{session_token}/flags, POST /api/v1/attempts/{session_token}/submit

AT-406 — Quiz not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts, POST /api/v1/members/attempts

AT-407 — Quiz not available​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts, POST /api/v1/members/attempts

AT-408 — Invalid attempt state​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/attempts/{session_token}, POST /api/v1/attempts/{attempt_id}/force-submit, POST /api/v1/attempts/{session_token}/answers, POST /api/v1/attempts/{session_token}/submit

AT-409 — Time limit exceeded​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{session_token}/answers

AT-410 — Max attempts reached​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts, POST /api/v1/members/attempts

AT-411 — Event not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/transfer-event, POST /api/v1/members/attempts

AT-412 — Event not active​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/transfer-event, POST /api/v1/members/attempts

AT-413 — Event max attempts reached​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/members/attempts

AT-414 — Event ended​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{session_token}/answers, POST /api/v1/attempts/{session_token}/submit

AT-415 — Client required​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/members/attempts

AT-416 — An owner closed the attempt out from under the participant​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{session_token}/answers, POST /api/v1/attempts/{session_token}/submit

AT-417 — Attempt auto submitted​

The attempt ran out of time and was closed by the auto-submit worker.

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{session_token}/answers, POST /api/v1/attempts/{session_token}/submit

AT-429 — Quota exceeded​

  • Type: Error
  • HTTP status: 429 Too Many Requests
  • Returned by: POST /api/v1/attempts/{session_token}/answers, POST /api/v1/attempts/{session_token}/submit, POST /api/v1/attempts, POST /api/v1/members/attempts, POST /api/v1/questions/generate

AT-501 — Transfer source not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/transfer-event, POST /api/v1/attempts/{attempt_id}/transfer

AT-502 — Transfer open successor exists​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/transfer-event, POST /api/v1/attempts/{attempt_id}/transfer

AT-503 — Force submit source not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/force-submit

AT-504 — Transfer question count changed​

Owner event-retarget: quiz question count no longer matches the attempt.

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/attempts/{attempt_id}/transfer-event

AT-603 — Flag cap exceeded​

  • Type: Error
  • HTTP status: 429 Too Many Requests
  • Returned by: POST /api/v1/attempts/{session_token}/flags

Authentication​

AUTH-101 — Invalid credentials​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/login

AUTH-102 — Token creation failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/login

AUTH-103 — Registration disabled​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/user

AUTH-104 — Provider disabled​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/login

AUTH-201 — Invalid refresh token​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/refresh

AUTH-202 — Token creation failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/refresh

U-111 — Password hash failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/user

U-112 — User create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/auth/user

Events​

EV-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/events/{event_id}, GET /api/v1/events/{event_id}, PATCH /api/v1/events/{event_id}/metadata/ops, POST /api/v1/events/{event_id}/force-submit, POST /api/v1/events, PUT /api/v1/events/{event_id}

EV-405 — Quiz state invalid​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/events

OAuth​

AUTH-301 — Provider disabled​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /internal/v1/oauth/google/authorize, POST /internal/v1/oauth/google/exchange

AUTH-302 — Invalid provider token​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /internal/v1/oauth/google/exchange

AUTH-303 — Invalid oauth header​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /internal/v1/oauth/google/authorize

AUTH-304 — User create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /internal/v1/oauth/google/exchange

AUTH-305 — Token creation failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /internal/v1/oauth/google/authorize, POST /internal/v1/oauth/google/exchange

Participants​

PT-101 — Create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/participants/bulk-create, POST /api/v1/participants/bulk-import, POST /api/v1/participants

PT-102 — Update failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: PUT /api/v1/participants/{id}

PT-103 — Delete failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/participants/{id}

PT-404 — Not found​

  • Type: Error
  • HTTP status: 404 Not Found
  • Returned by: DELETE /api/v1/participants/{id}, GET /api/v1/members/{id}/client, GET /api/v1/members/{id}/public, GET /api/v1/participants/{id}, PUT /api/v1/participants/{id}

PT-409 — External id conflict​

  • Type: Error
  • HTTP status: 409
  • Returned by: POST /api/v1/participants/bulk-create, POST /api/v1/participants/bulk-import, POST /api/v1/participants

Question templates​

QTS-101 — Template create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/question-templates

QTS-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/question-templates/{id}

Questions​

QS-101 — Question create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/questions

QS-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/questions/{id}, GET /api/v1/questions/{id}/client, GET /api/v1/questions/{id}/public, GET /api/v1/questions/{id}, PATCH /api/v1/questions/{id}/metadata/ops, PUT /api/v1/questions/{id}

Quiz info​

LB-404 — Unauthorized​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/info/quizezz/leaderboard/{quiz_id}/public, GET /api/v1/info/quizezz/leaderboard/{quiz_id}

QI-400 — Bad request​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/info/attempts/{attempt_id}/answers, GET /api/v1/info/attempts/{attempt_id}/flags, GET /api/v1/info/attempts

QI-404 — Unauthorized​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: GET /api/v1/info/attempts/{attempt_id}/answers, GET /api/v1/info/attempts/{attempt_id}/flags, GET /api/v1/info/attempts, GET /api/v1/info/quizezz/participant/{quiz_id}, GET /api/v1/info/quizezz/participated/{quiz_id}, GET /api/v1/info/quizezz/{quiz_id}/flags/summary

Quizzes (read)​

QZ-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/quizzes/{id}, GET /api/v1/quizzes/shared/{access_code}, GET /api/v1/quizzes/{id}/public, GET /api/v1/quizzes/{id}/quiz-questions, GET /api/v1/quizzes/{id}, PATCH /api/v1/quizzes/{id}/metadata/ops, PATCH /api/v1/quizzes/{id}/tags/ops, POST /api/v1/quizzes/bind-questions, POST /api/v1/quizzes/compute-leaderboard, POST /api/v1/quizzes/evaluate-answer, POST /api/v1/quizzes/{id}/force-submit, POST /api/v1/quizzes/{id}/sync-evaluation, and 1 more

Quizzes (write)​

QZ-101 — Quiz create failed​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/quizzes

QZ-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/quizzes/{id}, GET /api/v1/quizzes/shared/{access_code}, GET /api/v1/quizzes/{id}/public, GET /api/v1/quizzes/{id}/quiz-questions, GET /api/v1/quizzes/{id}, PATCH /api/v1/quizzes/{id}/metadata/ops, PATCH /api/v1/quizzes/{id}/tags/ops, POST /api/v1/quizzes/bind-questions, POST /api/v1/quizzes/compute-leaderboard, POST /api/v1/quizzes/evaluate-answer, POST /api/v1/quizzes/{id}/force-submit, POST /api/v1/quizzes/{id}/sync-evaluation, and 1 more

Tickets​

TK-404 — Not found​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: DELETE /api/v1/tickets/{ticket_id}, POST /api/v1/tickets

TK-405 — Invalid scope​

  • Type: Error
  • HTTP status: 400 Bad Request
  • Returned by: POST /api/v1/tickets

Reserved codes​

Declared in the API contract but not currently emitted by any endpoint. They are listed so clients can recognise them, and so a client that already handles them keeps working if they become active.

AC-400 — Invalid field​

  • Type: Reserved
  • Domain: Quiz info
  • Returned by: no endpoint currently emits this code

AK-101 — Api key create failed​

  • Type: Reserved
  • Domain: API keys
  • Returned by: no endpoint currently emits this code

AK-102 — Api key limit exceeded​

  • Type: Reserved
  • Domain: API keys
  • Returned by: no endpoint currently emits this code

AK-111 — Revoke failed​

  • Type: Reserved
  • Domain: API keys
  • Returned by: no endpoint currently emits this code

AN-404 — Not found​

  • Type: Reserved
  • Domain: Analytics
  • Returned by: no endpoint currently emits this code

AT-103 — Attempt submit failed​

  • Type: Reserved
  • Domain: Attempts
  • Returned by: no endpoint currently emits this code

AT-601 — Flag reserved label​

  • Type: Reserved
  • Domain: Attempts
  • Returned by: no endpoint currently emits this code

AT-602 — Flag batch too large​

  • Type: Reserved
  • Domain: Attempts
  • Returned by: no endpoint currently emits this code

AT-604 — Flag detail too large​

  • Type: Reserved
  • Domain: Attempts
  • Returned by: no endpoint currently emits this code

LC-404 — Not found​

  • Type: Reserved
  • Domain: Licensing
  • Returned by: no endpoint currently emits this code

LC-422 — Invalid package​

  • Type: Reserved
  • Domain: Licensing
  • Returned by: no endpoint currently emits this code

QI-001 — Invalid input​

  • Type: Reserved
  • Domain: Question info
  • Returned by: no endpoint currently emits this code

QS-405 — Restricted​

  • Type: Reserved
  • Domain: Questions
  • Returned by: no endpoint currently emits this code

SC-404 — Not found​

  • Type: Reserved
  • Domain: Scoring
  • Returned by: no endpoint currently emits this code

TK-401 — Unauthorized​

  • Type: Reserved
  • Domain: Tickets
  • Returned by: no endpoint currently emits this code

Generated by scripts/dump_response_codes.py from the Rust source. Do not edit by hand — rerun the script after changing any response code.