Calling Plan: Block List
This set of APIs are tightly linked to the calling plans. A block list allows to further reduce the prefixes of a specific country and classification a customer can make a call to.
Get a specific calling plan: block list
Retrieves the calling plan block list for a group.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/groups/{uuid}/block_list
Authorization
Required role
groups.instance.block_list.instance.list
Path Parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
search | string | Used to perform a search through all searchable properties of a group that look like the string passed | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list was found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No calling plan block list found with this uuid |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
callingPlans | array | List containing the block list calling plan objects | no |
results | integer | Total number of results from the query | no |
pages | integer | Total number of pages according to pagination settings | no |
page | integer | Current displayed page from the set of pages | no |
next | string | A token used for infinite scrolling, to be used in the next call to retrieve subsequent records. Only present if the list of customer's licenses has to be continued | yes |
Example
{
"callingPlans": [
{
"classification": "standard",
"country": "Belgium",
"countryCode": "+32",
"id": 2,
"isoCode": "BE",
"name": "Belgium BL",
"region": "Europe",
"risk": -1,
"type": "block_list"
},
{
"classification": "",
"country": "Italy",
"countryCode": "+39",
"id": 15,
"isoCode": "IT",
"name": "Italy BL",
"region": "Europe",
"risk": -1,
"type": "block_list"
}
],
"page": 1,
"pages": 1,
"results": 2
}Create a calling plan: block list
Creates a block list associated to the group.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/groups/{uuid}/block_list
Authorization
Required role
groups.instance.block_list.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
countryCode | string | The country code for the block list | no |
country | string | The country for the block list | no |
isoCode | string | The ISO code for the block list | no |
name | string | The name for the block list | no |
region | string | The region for the block list | no |
type | string | The type of the calling plan block list | no |
Example
{
"country": "Afghanistan",
"countryCode": "+93",
"isoCode": "AF",
"name": "test",
"region": "Asia",
"type": "block_list"
}Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list was created successfully |
400 | Error while creating the calling plan block list |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
countryCode | string | The country code for the calling plan block list | no |
country | string | The country for the calling plan block list | no |
id | integer | The index of the calling plan block list | no |
isoCode | string | The ISO code for the calling plan block list | no |
name | string | The name of the calling plan block list | no |
region | string | The region for the calling plan block list | no |
type | string | The type of the calling plan block list | no |
Example
{
"country": "Afghanistan",
"countryCode": "+93",
"id": 335,
"isoCode": "AF",
"name": "test",
"region": "Asia",
"type": "block_list"
}Modify a calling plan: block list
Updates the details a block list associated to the group.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/groups/{uuid}/block_list/{id}
Authorization
Required role
groups.instance.block_list.instance.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the group |
id | integer | ID of the calling plan block list which you would like to modify |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
name | string | New name for the calling plan block list | no |
Example
{
"name": "Belgium BL"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list was updated successfully |
400 | Error while updating the calling plan block list |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | The index of the calling plan block list | no |
Example
{
"id":2
}Delete a calling plan: block list
Deletes a block list associated to the group.
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/groups/{uuid}/block_list/{id}
Authorization
Required role
groups.instance.block_list.instance.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the group |
id | integer | ID of the calling plan block list which you would like to delete |
URL/Query parameters
N/A
Body
N/A
Response
Status codes
| Parameter | Description |
|---|---|
204 | The calling plan block list was deleted successfully. If the calling plan block list didn't exist, the delete will be considered as being executed successfully |
400 | Error while deleting the calling plan block list |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
N/A
Get the list of calling plan: block list prefixes
Retrieves the block list prefixes associated to the group.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/groups/{uuid}/block_list/{id}/prefixes
Authorization
Required role
groups.instance.block_list.instance.prefixes.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
URL/Query parameters
N/A
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more groups found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No trunk calling plan block list prefix found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
search | string | Used to perform a search through all searchable properties of a group that look like the string passed | no |
prefixes | array | List containing all calling plan block list prefix objects in the calling plan block list | no |
Example
{
"prefixes": [
{
"id": 4,
"isExact": false,
"name": "234",
"prefix": "234"
}
]
}Create a calling plan: block list prefix
Creates a block list prefixes associated to the group.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/groups/{uuid}/block_list/{id}/prefixes
Authorization
Required role
groups.instance.block_list.instance.prefixes.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
isExact | string | The is exact status for the calling plan block list prefix | no |
prefix | string | The prefix for the calling plan block list prefix | no |
name | string | The name for the calling plan block list prefix | no |
Example
{
"isExact": true,
"prefix": "456",
"name": "456"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list prefix was updated successfully |
400 | Error while updating the calling plan block list prefix |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | The index of the calling plan block list prefix | no |
Example
{
"id": 34
}Modify a calling plan: block list prefix
Updates the details a block prefix list associated to the group.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/groups/{uuid}/block_list/{id}/prefixes/{pid}
Authorization
Required role
groups.instance.block_list.instance.prefixes.instance.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the group |
id | integer | ID of the calling plan block list |
pid | integer | ID of the calling plan block list prefix which you would like to modify |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
isExact | string | The is exact status for the calling plan block list prefix | no |
prefix | string | The prefix for the calling plan block list prefix | no |
name | string | The name for the calling plan block list prefix | no |
Example
{
"isExact": false,
"prefix": "324",
"name": "234"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list prefix was updated successfully |
400 | Error while updating the calling plan block list prefix |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | The index of the calling plan block list prefix | no |
Example
{
"id": 4
}Delete a calling plan: block list prefix
Deletes a block prefix list associated to the group.
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/groups/{uuid}/block_list/{id}/prefixes/{pid}
Authorization
Required role
groups.instance.block_list.instance.prefixes.instance.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the group |
id | integer | ID of the calling plan block list |
pid | integer | ID of the calling plan block list prefix which you would like to delete |
URL/Query parameters
N/A
Body
N/A
Response
Status codes
| Parameter | Description |
|---|---|
204 | The calling plan block list prefix was deleted successfully. If the calling plan block list prefix didn't exist, the delete will be considered as being executed successfully |
400 | Error while deleting the calling plan block list prefix |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
N/A
Get a specific calling plan: block list
Retrieves the calling plan block list for a trunk group.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.read
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
search | string | Used to perform a search through all searchable properties of a group that look like the string passed | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list was found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No calling plan block list found with this uuid |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
callingPlans | array | List containing the block list calling plan objects | no |
results | integer | Total number of results from the query | no |
pages | integer | Total number of pages according to pagination settings | no |
page | integer | Current displayed page from the set of pages | no |
next | string | A token used for infinite scrolling, to be used in the next call to retrieve subsequent records. Only present if the list of customer's licenses has to be continued | yes |
Example
{
"callingPlans": [
{
"classification": "standard",
"country": "Belgium",
"countryCode": "+32",
"id": 2,
"isoCode": "BE",
"name": "Belgium BL",
"region": "Europe",
"risk": -1,
"type": "block_list"
},
{
"classification": "",
"country": "Italy",
"countryCode": "+39",
"id": 15,
"isoCode": "IT",
"name": "Italy BL",
"region": "Europe",
"risk": -1,
"type": "block_list"
}
],
"page": 1,
"pages": 1,
"results": 2
}Create a calling plan: block list
Creates a block list associated to the trunk group.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
countryCode | string | The country code for the calling plan block list | no |
country | string | The country for the calling plan block list | no |
isoCode | string | The ISO code for the calling plan block list | no |
name | string | The name for the calling plan block list | no |
region | string | The region for the calling plan block list | no |
type | string | The type of the calling plan block list | no |
Example
{
"country": "Afghanistan",
"countryCode": "+93",
"isoCode": "AF",
"name": "test",
"region": "Asia",
"type": "block_list"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list was created successfully |
400 | Error while creating the calling plan block list |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
countryCode | string | The country code for the calling plan block list | no |
country | string | The country for the calling plan block list | no |
id | integer | The index of the calling plan block list | no |
isoCode | string | The ISO code for the calling plan block list | no |
name | string | The name of the calling plan block list | no |
region | string | The region for the calling plan block list | no |
type | string | The type of the calling plan block list | no |
Example
{
"country": "Afghanistan",
"countryCode": "+93",
"id": 335,
"isoCode": "AF",
"name": "test",
"region": "Asia",
"type": "block_list"
}Modify a calling plan: block list
Updates the details a block list associated to the trunk group.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list/{id}
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
id | integer | ID of the calling plan block list which you would like to modify |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
name | string | New name for the calling plan block list | no |
Example
{
"name": "Belgium BL"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list was updated successfully |
400 | Error while updating the calling plan block list |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | The index of the calling plan block list | no |
Example
{
"id":2
}Delete a calling plan: block list
Deletes a block list associated to the trunk group.
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list/{id}
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
id | integer | ID of the calling plan block list which you would like to delete |
URL/Query parameters
N/A
Body
N/A
Response
Status codes
| Parameter | Description |
|---|---|
204 | The calling plan block list was deleted successfully. If the calling plan block list didn't exist, the delete will be considered as being executed successfully |
400 | Error while deleting the calling plan block list |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
prefixes | array | Universal unique id uniquely identifying the calling plan block list that has been deleted | no |
Example
{
"prefixes":[]
}Get the list of calling plan: block list prefixes
Retrieves the block list prefixes associated to the trunk group.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list/{id}
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.prefixes.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
id | integer | ID of the calling plan block list which you would like to retrieve |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
search | string | Used to perform a search through all searchable properties of a group that look like the string passed | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more groups found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No trunk calling plan block list prefix found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
search | string | Used to perform a search through all searchable properties of a group that look like the string passed | no |
prefixes | array | List containing all calling plan block list prefix objects in the calling plan block list | no |
Example
{
"prefixes": [
{
"id": 4,
"isExact": false,
"name": "234",
"prefix": "234"
}
]
}Create a calling plan: block list prefix
Creates a block list prefixes associated to the trunk group.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list/{id}/prefixes
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.prefixes.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
isExact | string | The is exact status for the calling plan block list prefix | no |
prefix | string | The prefix for the calling plan block list prefix | no |
name | string | The name for the calling plan block list prefix | no |
Example
{
"isExact": true,
"prefix": "456",
"name": "456"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list prefix was updated successfully |
400 | Error while updating the calling plan block list prefix |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | The index of the calling plan block list prefix | no |
Example
{
"id": 34
}Modify a calling plan: block list prefix
Updates the details a block list prefixes associated to the trunk group.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list/{id}/prefixes/{pid}
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.prefixes.instance.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
id | integer | ID of the calling plan block list |
pid | integer | ID of the calling plan block list prefix which you would like to modify |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
isExact | string | The is exact status for the calling plan block list prefix | no |
prefix | string | The prefix for the calling plan block list prefix | no |
name | string | The name for the calling plan block list prefix | no |
Example
{
"isExact": false,
"prefix": "324",
"name": "234"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The calling plan block list prefix was updated successfully |
400 | Error while updating the calling plan block list prefix |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | The index of the calling plan block list prefix | no |
Example
{
"id": 4
}Delete a calling plan: block list prefix
Deletes a block list prefixes associated to the trunk group.
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/trunkgroups/{trunkgroup_id}/block_list/{id}/prefixes/{pid}
Authorization
Required role
tenants.instance.subscriptions.instance.trunk_group.instance.block_list.instance.prefixes.instance.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | System generated universal unique ID (UUID) identifying the tenant |
subscription_id | integer | Index of a subscription to retrieve the calling plan block list for |
trunkgroup_id | integer | Index of a Trunk Group |
id | integer | ID of the calling plan block list |
pid | integer | ID of the calling plan block list prefix which you would like to delete |
URL/Query parameters
N/A
Body
N/A
Response
Status codes
| Parameter | Description |
|---|---|
204 | The calling plan block list prefix was deleted successfully. If the calling plan block list prefix didn't exist, the delete will be considered as being executed successfully |
400 | Error while deleting the calling plan block list prefix |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
N/A
