Get Information about a Device Group:

`GET /groups/{accountname}/name/{gname}`

Returns the name, description, and list of devices in a device group.

Get Information about a Device Group:
GET /groups/{accountname}/name/{gname}

Request Components

HTTP Request

GET https://thingspace.verizon.com/api/m2m/v1/groups/{accountname}/name/{gname}?next={deviceId}

Resource and Query Parameters

You must specify the account name and group name in the resource path.

Parameter Name	Data Type	Description
accountname required	string	The name of the account that contains the device group. An account name is usually numeric, and must include any leading zeros.
gname required	string	The name of the device group.
next optional	int64	(Output paging parameter) Only return information about devices that have an ID greater than this value. For the first request, don’t include this parameter in order to retrieve the devices with the smallest IDs. If the response status code is 200 then you have received the complete list of devices in the device group. If the response status code is 202, use the URL from the Location header in the response to send another request – it contains the correct value for the next parameter. Continue sending requests with the latest Location URL until you get a response with a status code of 200. This ensures that all devices are retrieved exactly once, with no gaps or overlaps in devices returned by multiple requests.

Header Parameters

The request header must contain a current ThingSpace authorization bearer token and a valid VZ-M2M session token, and must set the content-type to JSON.

Parameter Name	Data Type	Description
Authorization required	string	HTTP Authorization bearer token.
VZ-M2M-Token required	string	A valid session token returned by POST /session/login.
Content-Type required	string	Must be `application/json`.

Request Body

none

Success Responses

Status 200 or 202 The devices in a device group are returned sorted by device ID, with the smallest ID first.

Parameter Name	Data Type	Description
name	string	The name of the device group.
description	string	The description of the device group.
devices	Array of deviceIds objects	The devices in the device group.
kind	string	The type of the device identifier.
id	string	The value of the device identifier.
hasMoreData	boolean	False for a status 200 response. True for a status 202 response, indicating that there is more data to be retrieved. Send another request and include the `next` parameter to get the next block of records.

Example Success Response

{  
   "name":"Nebraska Trucks",
   "description":"All service trucks in Nebraska",
   "hasMoreData":false,
   "devices":[  
      {  
         "deviceIds":[  
            {  
               "id":"12345",
               "kind":"meid"
            },
            {  
               "id":"54321",
               "kind":"mdn"
            }
         ]
      },
      {  
         "deviceIds":[  
            {  
               "id":"456789",
               "kind":"meid"
            },
            {  
               "id":"987654",
               "kind":"mdn"
            }
         ]
      }
   ]
}

Failure Responses

Status 400

All error messages are returned in this format:

{
  "errorCode": "error code string",
  "errorMessage": "error message string"
}

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

Try It Out!