Get the status of a location report:

GET /locationreports/{account}/report/{txid}/status

Returns the current status of a location report that was requested with a POST /locationreports request.





See also:
Create a Device Location Report
Retrieve a Device Location Report
Cancel a Device Location Report

Request Components

HTTP Request


Resource Path and Query Parameters

You must include the account name and transaction ID in the path.

Parameter Name Data Type Description
string The name of the account that the report was requested for.
string The transaction ID from the POST /locationreports response.

Header Parameters

The request header must contain a current ThingSpace authorization bearer token and a valid VZ-M2M session token.

Parameter Name Data Type Description
string HTTP Authorization bearer token.
string A valid session token returned by POST /api/m2m/v1/session/login.

Request Body


Success Responses

Status 200

A success response contains the current status of the report.

Parameter Name Data Type Description
txid string The transaction ID of the report.
status enum QUEUED, INPROGRESS, or COMPLETED. Once a report is completed, you can retrieve it with a GET /locationreports request.

Example Success Response

  "txid": "2c90bd28-ece4-42ef-9f02-7e3bd4fbff33",
  "status": "INPROGRESS"

Failure Responses

Status 400

All error messages are returned in this format:

  "errorCode": "The type of error, such as INVALID_REQUEST.",
  "errorMessage": "Additional error information."

Error codes and messages are listed on the Error Codes page, along with explanations and suggestions for corrective actions.