API Reference
Log in to see full request history

How It Works

  1. Tenant calls Mondia’s API from the backend, sending the user’s mobile number in the request body.
  2. Mondia creates a session and returns a session ID/token.
  3. Tenant loads an iframe using the session token.
  4. Mondia retrieves user details and proceeds with the subscription using OTP.

API Request Details

  1. Set the correct Request Header details
HeaderValue
Content-Typeapplication/json
AuthorizationBearer {Your API Key}
  1. Provide at least one of the relevant user details in the Request Body
Request BodyDescriptionRequired
msisdnCustomer’s mobile numberYes
emailCustomer’s email idYes

Response Details

ResponseDescriptionRequired
session_idUnique session tokenYes
expires_inExpiry Duration in SecondsYes

Loading the Session in an Iframe
Once the session is created, Tenant loads the iframe using the "session_id" value:

html

<iframe src="https://mondia-portal.com?session_id=XYZ123" />


Subscription via OTP

  1. Mondia retrieves the user details using the session token.
  2. The user proceeds with the subscription flow using OTP authentication.
Form Data
string
Defaults to 123456789

Customer’s mobile number.

string
Defaults to xyz@mondia.com

Customer’s email Id.

Headers
string
Defaults to application/json

!DO NOT CHANGE OR REMOVE!

string
Defaults to Bearer {YOUR_API_KEY}

This field is mandatory and should follow the format: Bearer then single space then the provided Tenant API Key. This will be shared by the relevant Technical SPOC.

Responses

Language
URL
Request
Click Try It! to start a request and see the response here! Or choose an example:
application/json