Get the Status of an Asynchronous Request (eUICC)

Get the Status of an Asynchronous Request (for eUICC)

GET /v2/accounts/{accountname}/requests/{requestID}/status

Shows the current status of a specific request. Since requests are Asynchronous and require a callback to review results, this request will show if a request has failed, processed or is queued to run.

Contents

Request Components

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 bearer token:
Authorization: Bearer {token}

VZ-M2M-Token
required
string

A valid session token:
VZ-M2M-Token: {M2Mtoken}

Content-Type
required
string

Must be application/json:
Content-Type: application/json

HTTP Request

GET https://thingspace.verizon.com/m2m/v2/accounts/{accountname}/requests/{requestID}/status

Request Parameters

Parameter Data Type Description
accountName
required
string The name of the account.
requestId
required
string The system generated request ID from the request made.

Request Body

Example request:

/v2/accounts/1567889922-00001/requests/86c83330-4bf5-4235-9c4e-a83f93aeae4c/status

Success Response

Status 200

Example Response:

{
   "requestId":"86c83330-4bf5-4235-9c4e-a83f93aeae4c",
   "status":"Success",
   "subRequests":[
      {
         "ids":[
            {
               "id":"89148000000800784258",
               "kind":"ICCID"
            }
         ],
         "status":"Success"
      },
      {
         "ids":[
            {
               "id":"8179283174873",
               "kind":"iccid"
            }
         ],
         "status":"Pending"
      }
   ]
}

Success Parameters

Parameter Data Type Description
requestId
string The system generated request ID from the request made.
status
string

The overall status of the request and will be one of the following:

  • Success
  • Failed
  • Pending 
subRequests
array The devices included in the request.
   ids
array

An array of devices, by id, that are included in the request. Each ids will contain:

  • id
  • kind
  • status
      id
string The numeric ID of the device.
      kind
string

The the type of device ID represented by the ID value. This could be:

  • imei
  • iccid
  • mdn
  • eid
   status
string

The status of the request on a specific device and will be one of the following:

  • Success
  • Failed
  • Pending 

Failure Responses

All error responses will be in the following format

{
  "errorCode": "The 3-digit HTML error code",
  "errorMessage": "string"
}