Domain Subscription & CRM API - API Documentation

API Reference

API documentation for managing Domain Deployments and Subscriptions in Sada Mia Hosting Panel.

POST /api/customers

Create Customer

Create a new CRM Customer record which will own a domain deployment.

Authentication: Bearer Token

Parameters

Name	Type	Description
name *	string	Customer full name
email	string	Customer email address
business_name	string	Business name
phone	string	Contact phone number

Response Example 201

{
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "status": "lead"
}

POST /api/customers/{id}/deploy

Deploy Domain for Customer

Deploy an App or Load Balancer for the customer with a specific domain.

Authentication: Bearer Token

Parameters

Name	Type	Description
domain *	string	The domain name to deploy (e.g., example.com)
type	string	App type: nextjs, laravel, static (default: nextjs)
git_url	string	Git repository URL if deploying an App

Response Example 200

{
    "id": 1,
    "resource_type": "app",
    "status": "active",
    "resource": {
        "domain": "example.com"
    }
}

GET /api/subscription/plans

List Subscription Plans

Get a list of available active subscription plans in the system.

Authentication: Public / Bearer Token

Parameters

Name	Type	Description
type	string	Filter by type: flat_rate or request_credit

Response Example 200

{
    "plans": [
        {
            "id": 1,
            "name": "Pro Plan",
            "price": "10.00",
            "billing_cycle": "monthly"
        }
    ]
}

POST /api/subscription/subscribe

Initiate Subscription

Initiate a subscription payment via a gateway.

Authentication: Bearer Token

Parameters

Name	Type	Description
plan_id *	integer	ID of the subscription plan
gateway *	string	Payment gateway: bkash, nagad, sslcommerz
domain	string	Optional domain context

Response Example 200

{
    "transaction_id": 123,
    "payment_url": "https:\/\/sandbox.bka.sh\/...\/...",
    "gateway": "bkash"
}

POST /api/subscription/cancel

Cancel Subscription

GET /api/subscription/current

Current Subscription Status

GET /api/public/subscription/status

Public Subscription Status

Get detailed expiration info, customer data, and payment redirection for a specific domain. Used by external apps to check if they should show a payment block.

Authentication: Public

Parameters

Name	Type	Description
domain	string	The domain to check. Defaults to the requesting host if omitted.

Response Example 200

{
    "domain": "example.com",
    "customer": {
        "name": "John Doe",
        "email": "john@example.com",
        "business_name": "John Corp"
    },
    "is_deactivated": false,
    "is_expired": true,
    "expire_date": "2024-04-01T12:00:00Z",
    "notification_html": "<div class=\"subscription-notification\">...<\/div>",
    "payment_url": "https:\/\/pay.example.com",
    "support": {
        "email": "support@example.com",
        "whatsapp": "+123456789",
        "facebook": "fb.com\/support",
        "mobile": "+123456789"
    }
}

Common Status Codes

200 Success

The request was successful and the response contains the requested data.

402 Payment Required

Specifically used for domain subscription status when the subscription is expired or inactive.

401 Unauthorized

Missing or invalid Bearer Token. Ensure you include the Authorization header.