Error Handling

Common HTTP Status Codes

Status	Meaning	What to Check
400	Bad Request	Validation errors in request body — check required fields and data formats
401	Unauthorized	API token is invalid, expired, or missing
403	Forbidden	Insufficient permissions or resource access denied
404	Not Found	Resource does not exist or session has expired

Error Response Formats

Authentication errors:

{ "detail": "Invalid token." }

{ "detail": "Authentication credentials were not provided." }

Validation errors (field-level):

{
  "email": ["This field is required."],
  "student_id": ["This field is required."],
  "tenant": ["This field is required."]
}

Nested validation errors (within tenant/installment arrays):

{
  "tenant": [
    { "frequency": ["\"weekly\" is not a valid choice."] }
  ]
}

Processing errors:

{ "error": "Failed to download agreement document from provided URL" }

---