SMSBOX logo
API docs by Redocly

SMSBOX - Account API Documentation (1.0.0)

URL: https://www.smsbox.net

Changelog

Version Date Changes
1.0.0 01/15/2026 Initial Account API documentation (Credits and Users management).

Credit

Check your credit balance and manage credits for sub-accounts.

Check balance

Retrieve your current credit balance.

Usage: Add action=credit as a query parameter to the endpoint URL.

GET /1.1/api.php?action=credit
Authorizations:
ApiKey
query Parameters
action
required
string
Value: "credit"

Action identifier. Must be set to credit.

Responses

Request samples 

curl -X POST "https://api.smsbox.pro/1.1/api.php?action=credit" \
  -H "Authorization: App YOUR_API_KEY"

Response samples

Content type
text/plain
Example
CREDIT 22

Manage sub-account credit

Add or remove credits from a sub-account.

Credits are transferred from your main account balance.

Usage: Add action=credit as a query parameter to the endpoint URL.

POST /1.1/api.php?action=credit

No-limit option: Sub-accounts can be configured to use the main account's balance directly without allocated credits. Enable this option in "User Management" in your account dashboard.

Authorizations:
ApiKey
query Parameters
action
required
string
Value: "credit"

Action identifier. Must be set to credit.

Request Body schema: application/x-www-form-urlencoded
required
to
required
string

Sub-account username to manage credits for.

credit
required
integer

Number of SMS credits to add (positive) or remove (negative).

Credits are transferred from/to the main account balance.

Responses

Request samples 

curl -X POST "https://api.smsbox.pro/1.1/api.php?action=credit" \
  -H "Authorization: App YOUR_API_KEY" \
  -d "to=subaccount1&credit=100"

Response samples

Content type
text/plain
Example
OK

Users

Create and manage sub-accounts.

Limits:

  • Maximum 500 sub-accounts per main account
  • Username (pseudo): maximum 50 characters
  • Password (mdp): maximum 50 characters

Create sub-account

Create a new sub-account under your main account.

Usage: Add action=utilisateur as a query parameter to the endpoint URL.

POST /1.1/api.php?action=utilisateur

Limits:

  • Maximum 500 sub-accounts per main account
  • Username: maximum 50 characters
  • Password: maximum 50 characters
Authorizations:
ApiKey
query Parameters
action
required
string
Value: "utilisateur"

Action identifier. Must be set to utilisateur.

Request Body schema: application/x-www-form-urlencoded
required
do
required
string
Value: "add"

Operation type. Must be set to add to create a sub-account.

pseudo
required
string <= 50 characters

Username for the new sub-account.

Maximum 50 characters.

mdp
required
string <= 50 characters

Password for the new sub-account.

Maximum 50 characters.

nolimit
string
Enum: "yes" "no"

Enable "No-limit" option.

When set to yes, the sub-account can use credits from the main account balance directly.

Responses

Request samples 

curl -X POST "https://api.smsbox.pro/1.1/api.php?action=utilisateur" \
  -H "Authorization: App YOUR_API_KEY" \
  -d "do=add&pseudo=subaccount1&mdp=SecurePassword123&nolimit=yes"

Response samples

Content type
text/plain
Example
OK