API Reference
Find Registered Callback Listeners
GET /callbacks
Find a registered callback listener for an account by account number.
HTTP Request
GET https://thingspace.verizon.com/api/hyper-precise/v1/callbacks?accountNumber={accountNumber}
Header Parameters
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 request header containing a valid Bearer token: Authorization: Bearer {token} |
| VZ-M2M-Token (required) | string | A valid session token returned by a Connectivity Management POST /session/login request. |
| Content-Type (required) | string | Must be application/json. |
Request Parameters
| Parameter Name | Data Type | Description |
|---|---|---|
| accountNumber (required) | string | A unique identifier for an account. |
Request Body
None.
Success Response
Status 200
A successful response will display the billing account number (aname), the name of the callback service (name) and the address of the callback listening service (url).
Example response:
[
{
"aname": "string",
"name": "string",
"url": "string"
}
]Failure Responses
400 - Bad Request.
{
"errorCode": "INVALID_PARAMETER",
"errorMessage": "Device Not Found, Request will be queued"
}401 - Unauthorized request. Access token is missing or invalid.
{
"errorCode": "INVALID_ACCESS",
"errorMessage": "The access policy denied the resource operation for this user"
}403 - Forbidden request.
{
"errorCode": "INVALID_PARAMETER",
"errorMessage": "Device Not Certified"
}404 - Bad request. Not found.
{
"errorCode": "INVALID_PARAMETER",
"errorMessage": "Device inactive"
}409 - Bad request. Conflict state.
{
"errorCode": "INVALID_PARAMETER",
"errorMessage": "Service Not Purchased"
}500 - Internal Server Error.
{
"errorCode": "INTERNAL_ERROR",
"errorMessage": "Device is active in several accounts"
}