New Line Quick Add — API Documentation

Create a new line (connection) request quickly with just the customer's name and mobile number.

Endpoint

MethodPOST
URLhttps://billing.circlenetworkbd.net/api/new-line-req-quick-add
AuthNone (public endpoint)
Content-Typeapplication/x-www-form-urlencoded or application/json

Request Parameters

FieldTypeRequiredRuleDescription
namestringYesrequiredCustomer full name
phonestringYesexactly 11 digitsCustomer mobile number (e.g. 01712345678)
Notes

Example Request

cURL

curl -X POST "https://billing.circlenetworkbd.net/api/new-line-req-quick-add" \
  -H "Accept: application/json" \
  -d "name=Rahim Uddin" \
  -d "phone=01712345678"

JSON body

POST /api/new-line-req-quick-add HTTP/1.1
Host: billing.circlenetworkbd.net
Content-Type: application/json
Accept: application/json

{
  "name": "Rahim Uddin",
  "phone": "01712345678"
}

Responses

All responses return HTTP 200 with a JSON body containing an error flag. Always check the error field, not the HTTP status.

Success

{
  "error": false,
  "message": "Data saved successfully"
}

The message text is configurable on the server, so it may differ.

Validation error (missing / invalid fields)

{
  "error": true,
  "message": {
    "name": ["The name field is required."],
    "phone": ["The phone must be 11 digits."]
  }
}

Duplicate request (same number within 24 hours)

{
  "error": true,
  "message": {
    "already_exist": "Your are already applied for new line. Please try after 24 hour."
  }
}

Business Rules

  1. Duplicate protection: The same phone number can submit only once per day. A second request with the same number on the same calendar day is rejected with the already_exist message.
  2. Source: Every request created through this endpoint is tagged with a fixed internal source.
  3. Status: The request is created with an internal status of quick request and then processed by the operations team inside the panel.

Quick Integration Checklist