Skip to main content

Get Device by SID

This request returns data for a device, targeted by secure ID.

get /push/devices/{device_sid}

Sample

A sample GET request to get a device, targeted by secure ID:

curl -X GET \
'https://api.carrierx.com/core/v2/push/devices/56d485ae-0693-421a-91eb-6b02b152573a' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'

Response

200 status code with a serialized copy of the Device object:

{
"application_sid": "b3edc875-f73c-4c48-895a-8697b92b8d07",
"application_version": null,
"device_sid": "56d485ae-0693-421a-91eb-6b02b152573a",
"environment": "production",
"os_version": null,
"partner_sid": "e00430c3-a7d0-4666-ab5c-f7202448382f",
"token": "1111",
"type": "ios"
}

This request is enabled for Field Filtering.

Required Scopes

To get information about a Device object, the partner must have one of the following scopes enabled:

  • push.manage
  • push.read

Path Arguments

ParameterData TypeDescription
device_sid requiredstringThe device secure ID.

Query Arguments

ParameterData TypeDescription
with_relatedbooleanDetermines if the partner information related to the device should be shown. Values accepted in this field are true and false. The default value is false.