Get current pass marks

Retrieve the current active pass mark configuration (singleton pattern). Use Cases:

• Display current pass mark thresholds to administrators
• Validate student marks against configured pass marks
• Show pass mark information on assessment forms
• System initialization checks Singleton Behavior:
• The system maintains only one active pass mark configuration
• Uses .first() to retrieve the singleton instance
• Returns default values if no configuration exists Default Fallback: If no pass mark configuration is found:
• Returns found: false
• Provides default pass marks: 50 for both O-Level and A-Level
• Includes informative message about using defaults Response Structure: When configuration exists:
• found: true
• data: Full PassMark object with o_level and a_level values When no configuration exists:
• found: false
• message: Explanation about using defaults
• data: Default values (both levels = 50) Error Handling:
• Catches all exceptions and returns 500 status
• Provides error message in response
• Sets found to false on errors

GET /api/v1/school/pass-marks/current

Get current pass marks

cURL

curl --request GET \
  --url https://api.example.com/api/v1/school/pass-marks/current/ \
  --header 'Authorization: Bearer <token>'

200

Success-ConfigurationExists

{
  "found": true,
  "data": {
    "id": "uuid-123",
    "o_level": 50,
    "a_level": 50,
    "created_at": "2025-10-10T10:00:00Z",
    "updated_at": "2025-10-10T10:00:00Z"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

{key} · any