Partner API Integration

Developer Documentation

Integrate our Charging Management System with your Building Management System, Facility Management Software, or any other platform.

Auth

1. Authentication

Authenticate with your credentials to receive a JWT token. Use this token for all subsequent API calls.

Note: The token expires in 7 days. After expiry, you must login again to get a new token.

Login

Authenticate with your credentials to receive a JWT token.

POST/api/user/login

AuthorizationPublic

Request Body

JSON

{
  "email": "partner@example.com",
  "password": "your_password"
}

Response

JSON

{
  "success": true,
  "data": {
    "message": "Login successful",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "role": "owner",
    "organisation_name": "Your Organisation Name",
    "user_id": 12
  }
}

Verify Token

Check if your current token is still valid.

POST/api/user/checkToken

AuthorizationBearer <your_jwt_token>

Response

JSON

{
  "success": true,
  "message": "Token is valid"
}

Change Password

Change the password for the currently authenticated user.

PUT/api/user/password

AuthorizationBearer <your_jwt_token>

Request Body

JSON

{
  "password": "new_secure_password"
}

Response

JSON

{
  "success": true,
  "data": {
    "message": "Password updated successfully"
  }
}

Forgot Password — Send OTP

Request an OTP to reset your password.

POST/api/user/send-otp

AuthorizationPublic

Request Body

JSON

{
  "email": "partner@example.com"
}

Response

JSON

{
  "success": true,
  "message": "OTP sent successfully"
}

Forgot Password — Verify OTP & Reset

Verify the OTP and set a new password.

POST/api/user/verify-otp

AuthorizationPublic

Request Body

JSON

{
  "email": "partner@example.com",
  "otp": "123456",
  "newPassword": "new_secure_password"
}

Response

JSON

{
  "success": true,
  "message": "Password reset successfully"
}

Loading Data...

{ "success": true, "data": { "message": "Login successful", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "role": "owner", "organisation_name": "Your Organisation Name", "user_id": 12 } }