POST /v1/intelligence/wireless-coverage
Qualify addresses for Fixed Wireless Access unlimited plans. This API checks for both coverage and network capacity to sustain unlimited data plans.
The request header must set the content-type to JSON, contain a current ThingSpace authorization token and a current VZ-M2M session token. For more details on how to get these tokens, visit Getting Started.
Parameter Name | Data Type | Description |
---|---|---|
Authorization required |
string | HTTP Authorization bearer token: |
VZ-M2M-Token required |
string | A valid session token: |
Content-Type required |
string | Must be application/json: |
POST https://thingspace.verizon.com/api/m2m/v1/intelligence/wireless-coverage
All parameters are required unless marked "optional".
Parameter | Data Type | Description |
---|---|---|
accountName |
string | The numeric name of the account, including leading zeros. |
requestType | string | Set to FWA for address qualification. |
locationType | string | Specifies the location type used for the query. ADDRESS is the value to use fo this requestType. |
locations | object | Contains the location details to be queried. |
addressList | array | An array of address objects (up to 10,000 locations per billing account per day). |
addressLine1 | string | .The street number and name. |
addressLine2 optional |
string | Optional address information like suite number or building number. |
city | string | The name of the city. |
state | string | The 2 letter ISO-3066 state name. |
country | string | The 2 letter ISO-3066 country code or USA if in the United States. |
zip | string | The 5-digit postal, or zip, code. |
zip4 optional |
string | The optional +4 digit postal code added to the zip code. |
networkTypesList | array | An array of networkType objects. |
networkType | string | The type of network being queried. Valid values are:
Note: Only one networkType can be specified per request. |
Example request:
{
"accountName":"0000123456-00001",
"requestType":"FWA",
"locationType":"ADDRESS",
"locations":{
"addressList":[
{
"addressLine1":"123 Astreet",
"addressLine2":"Suite 01",
"city":"Basking Ridge",
"state":"NJ",
"country":"USA",
"zip":"07920",
"zip4":"optional +4 digit postal code"
},
{
"addressLine1":"123 Anotherstreet",
"addressLine2":"optional address information",
"city":"Basking Ridge",
"state":"NJ",
"country":"USA",
"zip":"07920",
"zip4":"optional +4 digit postal code"
}
]
},
"networkTypesList":[
{
"networkType":"C-BAND"
},
]
}
Status 200
A successful response shows a system generated request ID to track the request.
Example Response:
{
"requestId": "d1f08526-5443-4054-9a29-4456490ea9f8"
}
These endpoints send responses asynchronously. In order to read the results a callback is required.To learn more about callbacks, please visit About Callback Services. The callback service to subscribe to is IntelligenceService.
Example callback response for C-band:
{
"username" : "the user's login information",
"password" : "the user's password",
"requestId": "d1f08526-5443-4054-9a29-4456490ea9f8",
"intelligenceResponse": {
"wirelessCoverages": {
"fwaCoverage": [
{
"location": {
"address": {
"addressLine1": "123 Astreet",
"addressLine1": "Suite 01",
"city": "Basking Ridge",
"state": "NJ",
"zip": "07920"
}
},
"coverage": {
"networkType": "C-BAND",
"qualified": "true"
},
"status": "SUCCESS"
},
{
"location": {
"address": {
"addressLine1": "123 Anotherstreet",
"city": "Basking ridge",
"state": "NJ",
"zip": "07920"
}
},
"coverage": {
"networkType": "C-BAND",
"qualified": "false"
},
"status": "FAILED",
"reason": "Address not qualified for 5G coverage"
}
]
}
},
"status": "SUCCESS",
"callbackCount": 1,
"maxCallbackThreshold": 4
}
Example callback for Millimeter Wave (mmwave) which includes the maximum megabits per second (Mbps) speed supported at that address, depending on the mounting of the outdoor antenna.
{
"username" : "the user's login information",
"password" : "the user's password",
"requestId": "d1f08526-5443-4054-9a29-4456490ea9f8",
"intelligenceResponse": {
"wirelessCoverages": {
"fwaCoverage": [
{
"location": {
"address": {
"addressLine1": "123 Astreet",
"addressLine1": "Suite 01",
"city": "Basking Ridge",
"state": "NJ",
"zip": "07920"
}
},
"coverage": {
"networkType": "MMWAVE",
"qualified": "false"
},
"status": "FAILED",
"reason": "Address not qualified for mmwave coverage"
},
{
"location": {
"address": {
"addressLine1": "123 Anotherstreet",
"city": "Basking Ridge",
"state": "NJ",
"zip": "07920"
}
},
"coverage": {
"networkType": "MMWAVE",
"qualified": "true",
"speed": "300"
},
"status": "SUCCESS"
}
]
}
},
"status": "SUCCESS",
"callbackCount": 1,
"maxCallbackThreshold": 4
}
Parameter | Data Type | Description |
---|---|---|
username | string | The user's login information. |
password | object | The user's password. |
requestId | string | The requestId being viewed. This is a system generated value from the request above. |
intelligenceResponse | object | Details about the caalback response. |
wirelessCoverages | object | Details about the wireless coverage in the area queried. |
fwaCoverage | array | An array of objects containing network information based on the location information queried. |
location | object | Contains the location information being queried. |
address | object | Contains the address information queried. |
coverage | object | Details of coverage for the networkType queried. |
networkType | string | The type of network queried for. Values are:
|
qualified | boolean | Shows if the address is qualified for the networkType. Will be either true or false. |
speed | sring | Only valid for Millimeter wave. Shows the maximum throughput supported in Megabits per second. |
status | string | Based on the location information used, the status shows if the location is qualified to use the networkType (SUCCESS) or not (FAILED). |
reason | string | Reason for FAILED response. |
status | string | The status of the intelligenceResponse. |
callbackCount | string | The number of responses for intelligenceResponse found. |
maxCallbackThreshold | string | The maximum number of responses for intelligenceResponse allowed. |
All error responses will be in the following format
{
"errorCode": "The 3-digit HTML error code",
"errorMessage": "string"
}