Skip to main content

Get Short Code by SID

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

get /phonenumber/short_codes/{short_code_sid}

Sample

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

curl -X GET \
'https://api.carrierx.com/core/v2/phonenumber/short_codes/531f65b7-dff7-42b4-b638-597f91da9ccc' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'

Response

200 status code with a serialized copy of the Short Code object:

{
"attributes": {},
"callback_url": null,
"country_code": "USA",
"did_group_sid": "9cf3c0aa-3f80-43f7-b8c2-8f88251ff562",
"locality": null,
"lrn_sid": null,
"name": "test",
"partner_sid": "b9ba2c8b-2368-4a0b-9ba0-866ff2618417",
"short_code": "26399",
"short_code_sid": "531f65b7-dff7-42b4-b638-597f91da9ccc",
"state": "IL",
"string_key_1": null,
"string_key_2": null
}

This request is enabled for Field Filtering.

Required Scopes

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

  • phonenumber.manage
  • phonenumber.read

Path Arguments

ParameterData TypeDescription
short_code_sid requiredstringThe short code secure ID.

Query Arguments

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