Error Code Reference
Complete documentation of all error codes in the ArrivTrack system
Documentation Status Guide
Active = currently emitted by live backend/mobile flows.
Compatibility = route/page retained for older links or fallback flows.
Deprecated = no active route; kept in source for historical reference.
Compatibility = route/page retained for older links or fallback flows.
Deprecated = no active route; kept in source for historical reference.
HTTP Standard Errors
400
Bad Request
The server cannot process the request due to a client error (malformed
syntax, invalid request, etc.).
Common causes: Invalid JSON, missing required fields, malformed data.
401
Unauthorized
Authentication is required and has failed or has not been provided.
Common causes: Missing or invalid authentication token, expired
session.
403
Forbidden
The server understood the request but refuses to authorize it.
Common causes: Insufficient permissions, role restrictions, invalid
subscription.
404
Not Found
The requested resource could not be found on the server.
Common causes: Invalid URL, deleted resource, user not found.
405
Method Not Allowed
The request method is not supported for the requested resource.
Common causes: Using GET instead of POST, incorrect HTTP method.
500
Internal Server Error
The server encountered an unexpected condition that prevented it from
fulfilling the request.
Common causes: Database errors, uncaught exceptions, server
misconfiguration.
Authentication & Authorization (5000-5099)
5000
Authentication Token Required
Authentication token is required but was not provided.
Location: API - QR check-in system
Action: Include valid authentication token in request headers.
Action: Include valid authentication token in request headers.
5001
Invalid Authentication Token
The provided authentication token is invalid or expired.
Location: API - token verification
Action: Re-authenticate to get a new token.
Action: Re-authenticate to get a new token.
5002
Invalid Student Token
The student authentication token is invalid.
Location: API - QR check-in system
Action: Verify student token and try again.
Action: Verify student token and try again.
5003
Parent Permission Required
Only parent accounts can perform this action.
Location: API - subscription and payment endpoints
Action: Log in with a parent account.
Action: Log in with a parent account.
5004
Verification Code Expired
The verification code has expired.
Location: Website - email verification
Action: Request a new verification code.
Action: Request a new verification code.
5005
Invalid Verification Code
The verification code is invalid or incorrect.
Location: Website - email verification
Action: Check the code and try again.
Action: Check the code and try again.
5006
Verification Code Mismatch
The verification code doesn't match the expected value.
Location: Website - email verification
Action: Verify you entered the correct code.
Action: Verify you entered the correct code.
5007
Notices Unretrievable
Notices could not be retrieved in the mobile app.
Status: Active
Location: Mobile App (ParentNotices.jsx)
Action: Refresh notices, verify network connectivity, and try again.
Location: Mobile App (ParentNotices.jsx)
Action: Refresh notices, verify network connectivity, and try again.
5008
Admin OAuth Blocked
Google OAuth login is blocked for admin and superuser accounts.
Status: Active
Location: API (GoogleAuthView)
API key: ADMIN_OAUTH_BLOCKED
Action: Use standard email/password login for admin accounts.
Location: API (GoogleAuthView)
API key: ADMIN_OAUTH_BLOCKED
Action: Use standard email/password login for admin accounts.
5020
Google OAuth Failed
The API failed to communicate with Google during OAuth authentication.
Location: Mobile App (Login.jsx)
Action: Check Google API configuration, verify network connectivity.
Action: Check Google API configuration, verify network connectivity.
5021
Login Credentials Invalid
Username or password is incorrect.
Location: Mobile App (Login.jsx)
Action: Verify credentials and try again.
Action: Verify credentials and try again.
5044
Missing Email Parameter
Not enough parameters were provided for Google OAuth login. Missing
EMAIL parameter.
Status: Active
Location: API (account/views.py - google_oauth)
Action: Ensure email is included in login request.
Location: API (account/views.py - google_oauth)
Action: Ensure email is included in login request.
5044G
Google OAuth Error
Google OAuth authentication encountered an unexpected error.
Location: API (account/views.py - google_oauth)
Action: Check Google OAuth configuration and API credentials.
Action: Check Google OAuth configuration and API credentials.
5044G_EMAIL_MISMATCH
Email Mismatch
The email from Google OAuth doesn't match the expected email.
Location: API (account/views.py - google_oauth)
Action: Verify the correct Google account is being used.
Action: Verify the correct Google account is being used.
5051
Legacy Summer Program Extension Block
Legacy page for summer-program extension restriction flows.
Status: Compatibility (routed but not used in current primary
flows)
Location: Website (error5051.html template)
Action: Use current subscription flows; keep for backward compatibility.
Location: Website (error5051.html template)
Action: Use current subscription flows; keep for backward compatibility.
Subscription & Payment (5050-5199)
5050
Deprecated Refund Return Window Page
Historical template for return/refund window logic.
Status: Deprecated (template retained, no active route)
Location: Website (login/error5050.html)
Action: Do not use in new flows.
Location: Website (login/error5050.html)
Action: Do not use in new flows.
5100
Subscription Extension Required
You must have an active subscription to extend it.
Location: API - create_subscription
Action: Purchase a new subscription before attempting to extend.
Action: Purchase a new subscription before attempting to extend.
5101
Subscription Already Active
You already have an active subscription. Cannot create a new one.
Location: API - create_subscription
Action: Wait for current subscription to expire or extend it instead.
Action: Wait for current subscription to expire or extend it instead.
5102
Subscription Error
General subscription error occurred.
Location: Website - subscriptionerror page
Action: Contact support for assistance.
Action: Contact support for assistance.
5053
Subscription Required
An active subscription is required to access this feature.
Location: Multiple - subscription checks
Action: Purchase or renew subscription to continue.
Action: Purchase or renew subscription to continue.
5056
Subscription Invalid
Your subscription is invalid or has been revoked.
Location: Multiple - subscription validation
Action: Contact support or renew subscription.
Action: Contact support or renew subscription.
5057
Subscription Date Passed
District date has passed. Cannot modify subscription.
Location: Website - district-date-passed.html
Action: Contact district administrator.
Action: Contact district administrator.
5052
Account Unextendable
Legacy account extension page retained for compatibility.
Status: Compatibility (routed, rarely emitted by current flows)
Location: Website - account-unextendable.html
Action: Contact support for account status.
Location: Website - account-unextendable.html
Action: Contact support for account status.
5055
Subscription Already Valid
Legacy page indicating the subscription is still valid.
Status: Compatibility (route retained for old links)
Location: Website - subscription-not-expired.html
Action: Continue using the active subscription and current billing flow.
Location: Website - subscription-not-expired.html
Action: Continue using the active subscription and current billing flow.
5058
Subscription Parameters Missing
Required subscription/customer parameters are missing for the request.
Status: Compatibility (route available; limited current usage)
Location: Website - subscription-parameters-missing.html
Action: Restart subscription setup and ensure required values are present.
Location: Website - subscription-parameters-missing.html
Action: Restart subscription setup and ensure required values are present.
Data & Validation (5200-5299)
5200
Invalid JSON
The request body contains malformed JSON that cannot be parsed.
Location: API - multiple endpoints
Action: Verify JSON syntax and ensure proper formatting.
Action: Verify JSON syntax and ensure proper formatting.
5201
Empty Request Body
The request body is empty when data is required.
Location: API - POST endpoints
Action: Include required data in request body.
Action: Include required data in request body.
5202
Invalid Child Count
The child count must be at least 1 for subscription creation.
Location: API - subscription endpoints
Action: Provide a valid child count (minimum 1).
Action: Provide a valid child count (minimum 1).
5203
Payment Method ID Required
Payment method ID is required but was not provided.
Location: API - payment method endpoints
Action: Include paymentMethodId in the request.
Action: Include paymentMethodId in the request.
5204
Invalid Request Data
The provided request data is invalid or incomplete.
Location: API - various endpoints
Action: Check all required fields are present and valid.
Action: Check all required fields are present and valid.
5205
Student Not Found
Student User object not found in the database.
Location: API - student-related endpoints
Action: Verify student exists and try again.
Action: Verify student exists and try again.
5206
User Not Found
The requested user could not be found.
Location: API - user management
Action: Check user ID and ensure user exists.
Action: Check user ID and ensure user exists.
5207
Student Not Registered
Student is not registered in the system.
Location: API - student verification
Action: Complete student registration process.
Action: Complete student registration process.
5208
User Already Exists
An account with this email or username already exists.
Status: Active
Location: API - registration_api
API key: USER_EXISTS
Action: Log in with the existing account or use another email.
Location: API - registration_api
API key: USER_EXISTS
Action: Log in with the existing account or use another email.
5209
Duplicate Student ID
A student with the submitted student ID already exists.
Status: Active
Location: API - registration_api
API key: DUPLICATE_ID
Action: Verify the student ID or contact district support.
Location: API - registration_api
API key: DUPLICATE_ID
Action: Verify the student ID or contact district support.
5059
Data Validation / Account Processing Error
The request data failed validation or account processing checks.
Status: Active
Location: Website/API - account processing and validation flows
Action: Check input data and correct any validation errors.
Location: Website/API - account processing and validation flows
Action: Check input data and correct any validation errors.
5060
Invalid Credentials / Incomplete Data
Credentials or required account fields were invalid or incomplete.
Status: Active
Location: Website registration/login fallback flow
Action: Re-enter required credentials and retry account setup.
Location: Website registration/login fallback flow
Action: Re-enter required credentials and retry account setup.
Mobile App Specific (5300-5399)
5300
Confirmation Code Not Entered
Confirmation code was not entered when required.
Location: Mobile App (Login.jsx)
Action: Enter the confirmation code to proceed.
Action: Enter the confirmation code to proceed.
5301
Location Services Disabled
Location services are required but not enabled on the device.
Location: Mobile App
Action: Enable location services in device settings.
Action: Enable location services in device settings.
5302
Notification Permission Denied
Push notification permission has been denied.
Location: Mobile App
Action: Enable notifications in app settings.
Action: Enable notifications in app settings.
5303
Camera Permission Denied
Camera permission is required for QR scanning but was denied.
Location: Mobile App (QR Scanner)
Action: Enable camera permission in app settings.
Action: Enable camera permission in app settings.
5310
All Fields Required
All form fields must be filled out.
Location: Mobile App (CreateParentAccount.jsx)
Action: Complete all required fields.
Action: Complete all required fields.
5311
Email Format Invalid
The email address format is invalid.
Location: Mobile App (CreateParentAccount.jsx)
Action: Enter a valid email address.
Action: Enter a valid email address.
5312
Password Length Invalid
Password must be at least 8 characters long.
Location: Mobile App (CreateParentAccount.jsx)
Action: Enter a password with at least 8 characters.
Action: Enter a password with at least 8 characters.
5313
Passwords Do Not Match
Password and confirmation password do not match.
Location: Mobile App (CreateParentAccount.jsx)
Action: Ensure both password fields match.
Action: Ensure both password fields match.
5322
Invalid District Selection
Invalid district selected.
Location: Mobile App (CreateStudentInfo.jsx)
Action: Select a valid school district.
Action: Select a valid school district.
5323
Invalid School Selection
Invalid school selected.
Location: Mobile App (CreateStudentInfo.jsx)
Action: Select a valid school.
Action: Select a valid school.
5324
Route Selection Required
At least one bus route must be selected.
Location: Mobile App (CreateStudentInfo.jsx)
Action: Select a bus route.
Action: Select a bus route.
5325
Invalid Stop Selection
Invalid bus stop selected.
Location: Mobile App (CreateStudentInfo.jsx)
Action: Select a valid bus stop.
Action: Select a valid bus stop.
5330
Age Verification Required
Age verification must be completed.
Location: Mobile App (CreateStudentVerifyAge.jsx)
Action: Complete age verification process.
Action: Complete age verification process.
5340
Validation Code Required
Validation code must be entered.
Location: Mobile App (CreateStudentInfoValidation.jsx)
Action: Enter the validation code.
Action: Enter the validation code.
5341
Validation Code Invalid
The validation code entered is invalid.
Location: Mobile App (CreateStudentInfoValidation.jsx)
Action: Check the code and try again.
Action: Check the code and try again.
System & Integration (5400-5499)
5035
Settings API Error
An error occurred in the Settings API endpoint.
Location: API (account/views.py - SettingsAPI)
Action: Check server logs for detailed error information.
Action: Check server logs for detailed error information.
5400
Driver ID Required
Driver ID is required but was not provided.
Location: API - QR check-in system
Action: Include driver ID in the request.
Action: Include driver ID in the request.
5401
Invalid Route
The specified bus route is invalid or does not exist.
Location: API - route management
Action: Verify route ID and ensure route exists.
Action: Verify route ID and ensure route exists.
5402
Route Not Found
No route found matching the specified criteria.
Location: API - GetRouteAPI
Action: Check route parameters and try again.
Action: Check route parameters and try again.
5403
Invalid Driver
Driver verification failed or driver does not exist.
Location: API - QR check-in system
Action: Verify driver credentials and registration.
Action: Verify driver credentials and registration.
5404
Email Service Error
Failed to send email notification.
Location: Email notification system
Action: Check email service configuration and recipient email.
Action: Check email service configuration and recipient email.
5405
SMS Service Error
Failed to send SMS notification.
Location: SMS notification system
Action: Verify phone number and SMS service status.
Action: Verify phone number and SMS service status.
5406
Django System Error
An unexpected Django framework error occurred.
Location: API - various endpoints
Action: Contact support with error details.
Action: Contact support with error details.
5407
Invalid Request Method
The request used an invalid HTTP method.
Location: API - method validation
Action: Use the correct HTTP method (GET, POST, etc.).
Action: Use the correct HTTP method (GET, POST, etc.).
Stripe Payment Specific (5500-5599)
5500
Payment Method Unusable
The payment method cannot be used for this transaction.
Location: API - Stripe payment processing
Action: Try a different payment method.
Action: Try a different payment method.
5501
Card Declined
The payment card was declined by the issuing bank.
Location: Stripe payment processing
Action: Try a different payment method or contact your bank.
Action: Try a different payment method or contact your bank.
5502
Insufficient Funds
The payment card has insufficient funds.
Location: Stripe payment processing
Action: Use a different payment method or add funds.
Action: Use a different payment method or add funds.
5503
Invalid Payment Method
The provided payment method is invalid or cannot be used.
Location: Stripe payment processing
Action: Verify payment method details and try again.
Action: Verify payment method details and try again.
5504
Payment Method Setup Failed
Failed to set up the payment method with Stripe.
Location: Stripe payment setup
Action: Check payment details and try again.
Action: Check payment details and try again.
5505
Stripe Customer Not Found
No Stripe customer ID found for this account.
Location: Stripe integration
Action: Contact support to resolve account linking issue.
Action: Contact support to resolve account linking issue.
5506
Payment Method Belongs to Another Customer
The payment method is already associated with a different Stripe
customer.
Location: API - add_payment_method
Action: Use a different payment method or contact support.
Action: Use a different payment method or contact support.
5507
Stripe API Error
General Stripe API error occurred during payment processing.
Location: API - Stripe integration
Action: Try again or contact support with error details.
Action: Try again or contact support with error details.