System Integration API Documentation

This guide explains how external systems can integrate with our platform.

1. System Registration

To integrate, your system must first register via our registration link:

2. Client ID & Secret

After registration, we will provide you with a client_id and client_secret for authentication.

3. Get Access Token

Before calling any API, you must get an access token using your client ID and secret.

{
  "client_id": "your-client-id",
  "client_secret": "your-client-secret"
}

4. Request For License Number

Use the access token in the Authorization header to call this API:

Request Payload :

{
  "service_data": {
    "fiscal_year": "2024-2025",
    "business_name": "ABC General Store",
    "business_name_en": "ABC General Store EN",
    "business_ward_no": 5,
    "business_holding_no": "H-123",
    "business_capital":10000000,
    "business_total_employee": 20,
    "business_organization_type": "Single/Joint/Other",
    "business_address": "123 Main Street, City",
    "business_start_date": "2024-03-15",
    "signboard_type": "LED",
    "signboard_size": 20,
    "license_fee": 5000,
    "surcharge_fee": 200,
    "tax_amount": 300,
    "due": 100,
    "signboard_fee": 150,
    "yearly_vat": 500,
    "book_fee": 50,
    "form_fee": 20,
    "other_fee": 30,
    "total_amount": 6400,
    "issue_date": "2025-01-10",
    "issue_time": "10:40:57",
    "expiry_date": "2026-01-09",
    "office_name": "City Corporation Office",
    "office_name_en": "City Corporation Office EN"
  },
  "client_data": {
    "owner_name": "Owner Name",
    "owner_name_en": "Owner Name",
    "father_name": "Milton Deb",
    "father_name_en": "Milton Deb",
    "mother_name": "Mina Das",
    "mother_name_en": "Mina Das",
    "spouse_name": "N/A",
    "spouse_name_en": "N/A",
    "owner_photo": "https://example.com/photo.jpg",
    "birth_registration_no": "1234567890",
    "gender": "Male",
    "national_id": "1234567890123",
    "mobile_number": "01712345678",
    "tin_number": "987654321",
    "bin_number": "987654323",
    "email": "rahul@example.com",
    "permanent_holding_no": "PH-12",
    "permanent_road_no": "R-45",
    "permanent_area": "Downtown",
    "permanent_ward_no": 3,
    "permanent_post_code": 1200,
    "permanent_union": "Union Name",
    "permanent_union_en": "Union Name EN",
    "permanent_thana": "Thana Name",
    "permanent_thana_en": "Thana Name EN",
    "permanent_district": "District Name",
    "permanent_district_en": "District Name EN",
    "permanent_division": "Division Name",
    "permanent_division_en": "Division Name EN",
    "present_holding_no": "H-78",
    "present_road_no": "R-21",
    "present_area": "Uptown",
    "present_ward_no": 2,
    "present_post_code": 1300,
    "present_union": "Present Union",
    "present_union_en": "Present Union EN",
    "present_thana": "Present Thana",
    "present_thana_en": "Present Thana EN",
    "present_district": "Present District",
    "present_district_en": "Present District EN",
    "present_division": "Present Division",
    "present_division_en": "Present Division EN"
  },
  "payment_data": {
    "payment_method": "bkash",
    "transaction_id": "TXN123456789",
    "amount": 6400,
    "payment_date": "2025-01-10"
  }
}
    

Response:

{
  "success": true,
  "status_code": 200,
  "message": "License Request Successfully!",
  "data": {
    "license_number": "100100203",
    "sequence_number": "1312256"
  }
}

5. Confirm License Number

Use the access token in the Authorization header to call this API:

Request Payload :

{
  "license_number": "100100203",
  "sequence_number": "1312256"
}

Response:

{
    "success": true,
    "status_code": 200,
    "message": "License Successfully Confirmed!",
    "data": true
}

6. Authorization Header

All API requests (except token request) must include this header:

Authorization: Bearer YOUR_ACCESS_TOKEN