API Overview

All ISE Parliament API endpoints are prefixed with /api/v1. Most require JWT Bearer authentication.

Base URL

When running locally: http://localhost:3000/api/v1

Authentication

1. Login: POST /api/v1/auth/login with email and password
2. Use the accessToken in the response
3. Send with each request: Authorization: Bearer <accessToken>
4. Refresh when expired: POST /api/v1/auth/refresh with refreshToken

Key Endpoint Groups

Group	Base Path	Description
Auth	/auth	Login, logout, refresh, MFA
Users	/users	User management, profiles
Sittings	/sittings	Sittings, attendance, floor control
Motions	/motions	Motions and amendments
Voting	/voting	Vote sessions, cast, results
Bills	/bills	Bills, amendments, participation
Committees	/committees	Committee management
Petitions	/petitions	Public petitions
Financial	/financial	BPS, estimates, supply resolutions
Broadcast	/broadcast	Live streams, redaction
Audit	/audit	Audit logs (Admin)
Roles	/roles	Role management (Admin)
Permissions	/permissions	System permissions reference
Admin	/admin	Settings, backup (Admin)

Live API Documentation

For interactive exploration, use the Swagger UI or visit /api/v1/docs when the backend is running.