Authenticate client profile credentials and obtain JWT access token.

Request Body

{
  "email": "admin@kalvimaram.org",
  "password": "adminpassword123"
}

Success Response (200 OK)

{
  "success": true,
  "data": {
    "session": { "access_token": "ey..." },
    "user": { "id": "uuid", "email": "admin@kalvimaram.org", "role": "Admin" }
  }
}

Create login account and profile for Donors, Technicians, or Officers.

Request Body

{
  "email": "donor@example.com",
  "password": "securepassword",
  "role": "Donor",
  "region": "Chennai",
  "first_name": "John",
  "last_name": "Doe"
}

Fetch the list of registered government schools. Supports optional filter query parameters: region, limit.

Register a new school in the operations database.

Request Body

{
  "name": "Govt High School",
  "udise_code": "33020100105",
  "state": "Tamil Nadu",
  "district": "Chennai",
  "block": "Adyar",
  "student_count": 250,
  "headmaster_name": "Rajesh K.",
  "mobile_number": "+919876543210"
}

Update fields of a registered school profile.

Permanently delete a school. Cascades to delete demands and bookings.

Fetch all repair requests. Filter using query params status (e.g. pending, approved, adopted).

Create a new resource request / repair demand for a school.

Request Body

{
  "school_id": "school_uuid",
  "title": "Repair RO Water Plant",
  "description": "Filter needs replacement.",
  "cost_estimate": 12000.00
}

Fetch active scheduled work order bookings and sponsorships.

Sponsor a demand request and create a work booking schedule.

Request Body

{
  "request_id": "request_uuid",
  "scheduled_date": "2026-07-01T10:00:00Z"
}

List profiles of all registered donor partners.

List all registered technician profiles and skills status.

Read registration status and emails for all database roles.

Update system role (e.g. Admin, State) and region restrict boundaries.

Request Body

{
  "role": "State",
  "region": "Tamil Nadu"
}