Billing

Manage your billing.

Retrieve tenant billing configurations.

get

Retrieve details of tenant billing configurations.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

enabledbooleanOptional

Enable call billing or not.

Default: false

accountstring · enumOptional

The billing account:
Can be either:

TENANT: Use company account for billing.
USER: Use private user account for billing.

Default: TENANTPossible values:

typestring · enumOptional

The billing type:
Can be either:

OFFLINE: Use offline charging for billing.
ONLINE: Use online charging for billing.

Default: OFFLINEPossible values:

4XX

Error

get/tenant/billing

GET /api/tenant/billing HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "enabled": true,
  "account": "TENANT",
  "type": "OFFLINE"
}

Update tenant billing configurations.

post

Update tenant billing configurations.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

enabledbooleanOptional

Enable call billing or not.

Default: false

accountstring · enumOptional

The billing account:
Can be either:

TENANT: Use company account for billing.
USER: Use private user account for billing.

Default: TENANTPossible values:

typestring · enumOptional

The billing type:
Can be either:

OFFLINE: Use offline charging for billing.
ONLINE: Use online charging for billing.

Default: OFFLINEPossible values:

Responses

200

No content

4XX

Error

post/tenant/billing

POST /api/tenant/billing HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "enabled": true,
  "account": "TENANT",
  "type": "OFFLINE"
}

No content

List call rates

get

Retrieve a collection of call rates

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

application/json

countinteger · int64Optional

Total number of resource.

Example: 100

4XX

Error

get/call_rates

GET /api/call_rates HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": "xxxxxx",
      "prefix": "example",
      "type": "LOCAL",
      "free_seconds": 0,
      "grace_period": 0,
      "interval_1": 1,
      "interval_n": 1,
      "postcall_surcharge": 0,
      "price_1": 0,
      "price_n": 0,
      "description": ""
    }
  ]
}

Create a call rate

post

Add a new call rate into system.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

prefixstring · min: 1 · max: 64Required

The call prefix of the rating.

typestring · enumRequired

The type of the rating:
Can be either:

LOCAL:
NATIONAL:
INTERNATIONAL:
MOBILE:

Default: LOCALPossible values:

free_secondsinteger · int32Required

Free seconds of the rating.

grace_periodinteger · int32Required

Grace period of the rating.

interval_1integer · int32 · min: 1Required

The first interval of the rating.

interval_ninteger · int32 · min: 1Required

The subsequent interval of the rating after the first one.

connect_feenumber · doubleRequired

Connect fee of the rating. Precision is five digits.

postcall_surchargenumber · doubleRequired

Postcall surcharge of the rating. Precision is five digits.

price_1number · doubleRequired

The price of the first interval. Precision is five digits.

price_nnumber · doubleRequired

The price of the subsequent interval after the first one. Precision is five digits.

descriptionstring · max: 1024Optional

The description text for this rule.

Responses

200

application/json

idstringOptionalExample: NzAwNTUxOTA5NzczMTQ4MTYw

4XX

Error

post/call_rates

POST /api/call_rates HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 179

{
  "prefix": "example",
  "type": "LOCAL",
  "free_seconds": 0,
  "grace_period": 0,
  "interval_1": 1,
  "interval_n": 1,
  "connect_fee": 1,
  "postcall_surcharge": 0,
  "price_1": 0,
  "price_n": 0,
  "description": ""
}

{
  "id": "xxxxxxxx"
}

Retrieve a call rate

get

Retrieve call rate by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

application/json

idstringOptionalExample: NzAwNTUxOTA5NzczMTQ4MTYw

prefixstring · min: 1 · max: 64Optional

The call prefix of the rating.

typestring · enumOptional

The type of the rating:
Can be either:

LOCAL:
NATIONAL:
INTERNATIONAL:
MOBILE:

Default: LOCALPossible values:

free_secondsinteger · int32Optional

Free seconds of the rating.

grace_periodinteger · int32Optional

Grace period of the rating.

interval_1integer · int32 · min: 1Optional

The first interval of the rating.

interval_ninteger · int32 · min: 1Optional

The subsequent interval of the rating after the first one.

connect_feenumber · doubleOptional

Connect fee of the rating. Precision is five digits.

postcall_surchargenumber · doubleOptional

Postcall surcharge of the rating. Precision is five digits.

price_1number · doubleOptional

The price of the first interval. Precision is five digits.

price_nnumber · doubleOptional

The price of the subsequent interval after the first one. Precision is five digits.

descriptionstring · max: 1024Optional

The description text for this rule.

4XX

Error

get/call_rates/{id}

GET /api/call_rates/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "xxxxxx",
  "prefix": "example",
  "type": "LOCAL",
  "free_seconds": 0,
  "grace_period": 0,
  "interval_1": 1,
  "interval_n": 1,
  "connect_fee": 1,
  "postcall_surcharge": 0,
  "price_1": 0,
  "price_n": 0,
  "description": ""
}

Update a call rate

post

Update call rate.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Body

prefixstring · min: 1 · max: 64Optional

The call prefix of the rating.

typestring · enumOptional

The type of the rating:
Can be either:

LOCAL:
NATIONAL:
INTERNATIONAL:
MOBILE:

Default: LOCALPossible values:

free_secondsinteger · int32Optional

Free seconds of the rating.

grace_periodinteger · int32Optional

Grace period of the rating.

interval_1integer · int32 · min: 1Optional

The first interval of the rating.

interval_ninteger · int32 · min: 1Optional

The subsequent interval of the rating after the first one.

connect_feenumber · doubleOptional

Connect fee of the rating. Precision is five digits.

postcall_surchargenumber · doubleOptional

Postcall surcharge of the rating. Precision is five digits.

price_1number · doubleOptional

The price of the first interval. Precision is five digits.

price_nnumber · doubleOptional

The price of the subsequent interval after the first one. Precision is five digits.

descriptionstring · max: 1024Optional

The description text for this rule.

Responses

200

No content

4XX

Error

post/call_rates/{id}

POST /api/call_rates/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 179

{
  "prefix": "example",
  "type": "LOCAL",
  "free_seconds": 0,
  "grace_period": 0,
  "interval_1": 1,
  "interval_n": 1,
  "connect_fee": 1,
  "postcall_surcharge": 0,
  "price_1": 0,
  "price_n": 0,
  "description": ""
}

No content

Delete a call rate

post

Destroy a call rate.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

No content

4XX

Error

post/call_rates/{id}/destroy

POST /api/call_rates/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Export call rates

get

Export a collection of call rates to file.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/octet-stream

Responsestring · binary

4XX

Error

get/call_rates/export

GET /api/call_rates/export HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

PreviousTenants NextCall Queues

Last updated 20 days ago

Was this helpful?