Account API (v2.1.6)

Download OpenAPI specification:Download

Account management

Account

Account, billing, and signup endpoints.

Add Account

Creates a new sub-account. Requires administrator API key. The new account password is auto-generated and returned in the response.

Authorizations:
apikey
Request Body schema: application/json
required

Body for add account.

name
required
string
username
required
integer

10-digit numeric account username.

apikey
required
string
email
required
string
masterAccount
integer

Billing account. Defaults to the new account username if omitted.

Responses

Request samples

Content type
application/json
{
  • "name": "Acme Corp",
  • "username": 4592086960,
  • "apikey": "Administrator API Key",
  • "email": "billing@example.com",
  • "masterAccount": 4592086960
}

Response samples

Content type
application/json
{
  • "account": {
    },
  • "statusCode": "200",
  • "status": "Success",
  • "message": "Account Information"
}

Get API Key

Returns the API key (Bearer token) for the account identified by username and password. No Bearer token is required or accepted. Rate limited to 6 requests per hour per IP.

Authorizations:
apikey
Request Body schema: application/json

Account credentials

username
required
integer

Account username.

password
required
string

Account password.

Responses

Request samples

Content type
application/json
{
  • "username": 1234567890,
  • "password": "abc1234567"
}

Response samples

Content type
application/json
{
  • "statusCode": "200",
  • "status": "Success",
  • "apikey": "dec759ed81963fd9a4b8a9c8f3e22b1a"
}

Call Detail Records

Returns call detail records for the account within a time range. start and end are Unix timestamps. Defaults: start=now, end=24 hours ago. Rate limited to 6 requests per hour per IP address.

Authorizations:
apikey
Request Body schema: application/json
required

Body for call detail records.

end
integer

End time as Unix timestamp. Defaults to 24 hours before current time.

start
integer

Start time as Unix timestamp. Defaults to current time.

apikey
required
string

Responses

Request samples

Content type
application/json
{
  • "end": 1699913600,
  • "start": 1700000000,
  • "apikey": "Your API Key"
}

Response samples

Content type
application/json
{
  • "cdr": [ ],
  • "statusCode": "200",
  • "status": "Success"
}

Account Info

Returns account details including balance, rate, and configuration. Rate limited to 6 requests per hour per IP address.

Authorizations:
apikey
Request Body schema: application/json
required

Body for account info.

apikey
required
string

Responses

Request samples

Content type
application/json
{
  • "apikey": "Your API Key"
}

Response samples

Content type
application/json
{
  • "account": [ ],
  • "statusCode": "200",
  • "status": "Success"
}

Monthly Recurring Charges

Returns the current monthly recurring charges broken down by service plus a total. Rate limited to 6 requests per hour per IP address.

Authorizations:
apikey
Request Body schema: application/json
required

Body for monthly recurring charges.

apikey
required
string

Responses

Request samples

Content type
application/json
{
  • "apikey": "Your API Key"
}

Response samples

Content type
application/json
{
  • "mrc": [ ],
  • "statusCode": "200",
  • "status": "Success"
}

Account Recovery

Sends a password recovery link to the email address associated with the account. No authentication required.

Request Body schema: application/json
required

Body for account recovery.

email
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "john@example.com"
}

Response samples

Content type
application/json
{
  • "statusCode": "200",
  • "status": "Success",
  • "message": "Please check your email (john@example.com) for details"
}

SIP Registration

Returns the current SIP registration details for the account including the registered SIP URI and user agent string.

Authorizations:
apikey
Request Body schema: application/json
required

Body for sip registration.

apikey
required
string

Responses

Request samples

Content type
application/json
{
  • "apikey": "Your API Key"
}

Response samples

Content type
application/json
{
  • "account": {
    },
  • "statusCode": "200",
  • "status": "Success"
}

Account Signup

Creates a new account. No authentication required. Returns account credentials. A verification email is sent to the provided address.

Request Body schema: application/json
required

Body for account signup.

name
required
string
email
required
string
promo
string

Optional promotional code.

Responses

Request samples

Content type
application/json
{
  • "name": "John Doe",
  • "email": "john@example.com",
  • "promo": "PROMO2024"
}

Response samples

Content type
application/json
{
  • "account": {
    },
  • "statusCode": "200",
  • "status": "Success",
  • "message": "Account Information"
}