Blacklisted numbers

List blacklisted numbers

get

Authorizations

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 · int32 · default: 0optional

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

topinteger · int32 · min: 1 · max: 100 · default: 100optional

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://HOSTNAME:8887/api/blacklisted_numbers' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

4XX

200

{
  "count": 100,
  "items": [
    {
      "id": "NzAwNTUxOTA5NzczMTQ4MTYw",
      "number": "text",
      "expire_at": "2017-07-21T17:32:28Z",
      "created_at": "2017-07-21T17:32:28Z",
      "updated_at": "2017-07-21T17:32:28Z",
      "description": "text"
    }
  ]
}

OK

Create new blacklisted number

post

Authorizations

Body

numberstring · min: 1 · max: 64required

An alphanumeric sequence beginning with an optional plus sign.

expire_atall ofoptional

Blacklisted number's expire time.

The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

descriptionstring · max: 255optional

Remarks for the blacklisted number.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://HOSTNAME:8887/api/blacklisted_numbers' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "number": "text",
    "expire_at": "2017-07-21T17:32:28Z",
    "description": "text"
  }'

201

4XX

201

{
  "id": "NzAwNTUxOTA5NzczMTQ4MTYw"
}

Created

Show blacklisted number

get

Authorizations

Path parameters

idall ofrequired

The unique ID of this blacklisted number.

The unique ID of the resource.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://HOSTNAME:8887/api/blacklisted_numbers/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

4XX

200

{
  "id": "NzAwNTUxOTA5NzczMTQ4MTYw",
  "number": "text",
  "expire_at": "2017-07-21T17:32:28Z",
  "created_at": "2017-07-21T17:32:28Z",
  "updated_at": "2017-07-21T17:32:28Z",
  "description": "text"
}

OK

Update blacklisted number

post

Authorizations

Path parameters

idall ofrequired

The unique ID of this blacklisted number.

The unique ID of the resource.

Body

numberstring · min: 1 · max: 64optional

An alphanumeric sequence beginning with an optional plus sign.

expire_atall ofoptional

Blacklisted number's expire time.

The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

descriptionstring · max: 255optional

Remarks for the blacklisted number.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://HOSTNAME:8887/api/blacklisted_numbers/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "number": "text",
    "expire_at": "2017-07-21T17:32:28Z",
    "description": "text"
  }'

200

4XX

200

No body

OK