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
}
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
| Prefix | Domain |
|---|---|
0000 | Generic 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
| Code | HTTP | Meaning | Domain |
|---|---|---|---|
0000 | 200 OK, 201 Created, 204 No Content | Ok | All domains |
AI-001 | 400 Bad Request | Config error | AI question generation |
AI-002 | 400 Bad Request | Generation failed | AI question generation |
AT-003 | 200 OK | Attempt retrieved | Attempts |
AT-004 | 200 OK | Transfer will auto close | Attempts |
AT-099 | 200 OK | Attempt finished | Attempts |
AT-101 | 400 Bad Request | Attempt create failed | Attempts |
AT-102 | 400 Bad Request | Answer submit failed | Attempts |
AT-401 | 400 Bad Request | Unauthorized | Attempts |
AT-402 | 400 Bad Request | Invalid access code | Attempts |
AT-404 | 400 Bad Request | Not found | Attempts |
AT-405 | 400 Bad Request | Already submitted | Attempts |
AT-406 | 400 Bad Request | Quiz not found | Attempts |
AT-407 | 400 Bad Request | Quiz not available | Attempts |
AT-408 | 400 Bad Request | Invalid attempt state | Attempts |
AT-409 | 400 Bad Request | Time limit exceeded | Attempts |
AT-410 | 400 Bad Request | Max attempts reached | Attempts |
AT-411 | 400 Bad Request | Event not found | Attempts |
AT-412 | 400 Bad Request | Event not active | Attempts |
AT-413 | 400 Bad Request | Event max attempts reached | Attempts |
AT-414 | 400 Bad Request | Event ended | Attempts |
AT-415 | 400 Bad Request | Client required | Attempts |
AT-416 | 400 Bad Request | An owner closed the attempt out from under the participant | Attempts |
AT-417 | 400 Bad Request | The attempt ran out of time and was closed by the auto-submit worker | Attempts |
AT-429 | 429 Too Many Requests | Quota exceeded | AI question generation, Attempts |
AT-501 | 400 Bad Request | Transfer source not found | Attempts |
AT-502 | 400 Bad Request | Transfer open successor exists | Attempts |
AT-503 | 400 Bad Request | Force submit source not found | Attempts |
AT-504 | 400 Bad Request | Transfer question count changed | Attempts |
AT-603 | 429 Too Many Requests | Flag cap exceeded | Attempts |
AUTH-001 | 400 Bad Request | Unauthorized | All domains |
AUTH-101 | 400 Bad Request | Invalid credentials | Authentication |
AUTH-102 | 400 Bad Request | Token creation failed | Authentication |
AUTH-103 | 400 Bad Request | Registration disabled | Authentication |
AUTH-104 | 400 Bad Request | Provider disabled | Authentication |
AUTH-201 | 400 Bad Request | Invalid refresh token | Authentication |
AUTH-202 | 400 Bad Request | Token creation failed | Authentication |
AUTH-301 | 400 Bad Request | Provider disabled | OAuth |
AUTH-302 | 400 Bad Request | Invalid provider token | OAuth |
AUTH-303 | 400 Bad Request | Invalid oauth header | OAuth |
AUTH-304 | 400 Bad Request | User create failed | OAuth |
AUTH-305 | 400 Bad Request | Token creation failed | OAuth |
DS-000 | 400 Bad Request | Infrastructure error | All domains |
EV-404 | 400 Bad Request | Not found | Events |
EV-405 | 400 Bad Request | Quiz state invalid | Events |
LB-404 | 400 Bad Request | Unauthorized | Quiz info |
PT-101 | 400 Bad Request | Create failed | Participants |
PT-102 | 400 Bad Request | Update failed | Participants |
PT-103 | 400 Bad Request | Delete failed | Participants |
PT-404 | 404 Not Found | Not found | Participants |
PT-409 | 409 | External id conflict | Participants |
QI-400 | 400 Bad Request | Bad request | Quiz info |
QI-404 | 400 Bad Request | Unauthorized | Quiz info |
QS-101 | 400 Bad Request | Question create failed | Questions |
QS-404 | 400 Bad Request | Not found | Questions |
QTS-101 | 400 Bad Request | Template create failed | Question templates |
QTS-404 | 400 Bad Request | Not found | Question templates |
QZ-101 | 400 Bad Request | Quiz create failed | Quizzes (write) |
QZ-404 | 400 Bad Request | Not found | Quizzes (read), Quizzes (write) |
TK-404 | 400 Bad Request | Not found | Tickets |
TK-405 | 400 Bad Request | Invalid scope | Tickets |
U-111 | 400 Bad Request | Password hash failed | Authentication |
U-112 | 400 Bad Request | User create failed | Authentication |
VAL-001 | 400 Bad Request | Invalid input | All domains |
VAL-002 | 400 Bad Request | Invalid params | All 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.