Getting started
Protected API requests require a verified user account, an active package, API credentials, an allowed server IP and enough wallet balance for the endpoint charge.
Setup from your dashboard: Open Packages and purchase access, then open API Credentials to generate a key and secret. Add the public IP of the server that will make requests. The private Web Integration screen provides examples using your actual credentials.
Base URL
https://www.mosarofhosen.top/api/v1Required headers
Accept: application/json
Content-Type: application/json
X-API-KEY: your_api_key
X-API-SECRET: your_api_secret
Access rules: Allowed IP configuration is mandatory. Allowed domain configuration is optional. Keep the API secret on your server and never expose it in browser-side JavaScript.
API availability check
This public endpoint confirms that the API route is available. It does not validate API credentials.
POST
/api/v1/auth/checkRequest
curl -X POST "https://www.mosarofhosen.top/api/v1/auth/check" \
-H "Accept: application/json"Response · HTTP 200
{
"success": true,
"message": "API সচল আছে"
}List available packages
GET
/api/v1/packagesRequest
curl -X GET "https://www.mosarofhosen.top/api/v1/packages" \
-H "Accept: application/json" \
-H "X-API-KEY: your_api_key" \
-H "X-API-SECRET: your_api_secret"Response · HTTP 200
{
"success": true,
"data": [
{
"package_key": "citizen_verify",
"name": "Citizen Verify",
"name_bn": "সিটিজেন আইডি ভেরিফাই",
"description": "Verification endpoint access with secure API credentials.",
"activation_fee": 4500,
"requests_per_minute": 30,
"requests_per_day": 5000,
"validity_days": 0,
"access_level": 1,
"is_active_on_account": false
}
]
}Activate a package
POST
/api/v1/packages/activateRequest
curl -X POST "https://www.mosarofhosen.top/api/v1/packages/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-API-KEY: your_api_key" \
-H "X-API-SECRET: your_api_secret" \
-d '{"package_key":"citizen_verify"}'Response · HTTP 200
{
"success": true,
"message": "Package activated successfully.",
"data": {
"package_key": "citizen_verify",
"activated_at": "2026-07-18T10:00:00.000000Z",
"expires_at": null
}
}