Get hosting order number

Request

Returns the specified phone number belonging to the specified hosting order.

Security

Basic or OAuth2.0

Path

projectIdstringrequired

Found on your Sinch Customer Dashboard. Settings > Projects.

Example:d1923022-5199-4bb3-a513-c47b3a656bc5

hostingOrderIdstringrequired

Found on your Sinch Customer Dashboard. Settings > Projects.

Example:01arz3ndektsv4rrffq69g5fav

phoneNumberstringrequired

The phone number in E.164 format with leading +.

Example:+12025550134

curl -i -X GET \
  -u '<username>:<password>' \
  'https://imported.numbers.api.sinch.com/v1/projects/d1923022-5199-4bb3-a513-c47b3a656bc5/hostingOrders/01arz3ndektsv4rrffq69g5fav/numbers/+12025550134'

Responses

OK

Bodyapplication/json

projectIdstring

The project ID to which the number belongs.

Example:"YOUR_project_id"

hostingOrderIdstring

The ID of the hosting order to which the number belongs.

Example:"YOUR_hosting_order_id"

phoneNumberstring

The phone number in e.164 format with leading +.

Example:"+12025550134"

osrUpdateobject(HostingOrderNumber_OsrUpdate)

An object containing information about the OSR update.

campaignProvisioningobject(HostingOrderNumber_CampaignProvisioning)

An object containing information about campaign provisioning.

platformProvisioningobject(HostingOrderNumber_PlatformProvisioning)

An object containing information related to the provisioning on the platform.

smsAttobject(CarrierState)

Contains information about hosted SMS AT&T numbers.

smsTmoobject(CarrierState)

Contains information about hosted SMS T-Mobile numbers.

mmsAttobject(CarrierState)

Contains information about hosted MMS AT&T numbers.

mmsTmoobject(CarrierState)

Contains information about hosted MMS T-Mobile numbers.

Response

{
  "projectId": "YOUR_project_id",
  "hostingOrderId": "YOUR_hosting_order_id",
  "phoneNumber": "+12025550134",
  "osrUpdate": {
    "nnid": "string",
    "state": "DONE"
  },
  "campaignProvisioning": {
    "campaignId": "YOUR_campaign_id",
    "state": "DONE"
  },
  "platformProvisioning": {
    "servicePlanId": "YOUR_service_plan_id",
    "state": "DONE"
  },
  "smsAtt": {
    "state": "DONE",
    "errorCode": "",
    "errorMessage": "string",
    "updateTime": "2025-04-02T19:45:28.650924Z"
  },
  "smsTmo": {
    "state": "DONE",
    "errorCode": "",
    "errorMessage": "string",
    "updateTime": "2025-04-02T19:45:28.650924Z"
  },
  "mmsAtt": {
    "state": "DONE",
    "errorCode": "",
    "errorMessage": "string",
    "updateTime": "2025-04-02T19:45:28.650924Z"
  },
  "mmsTmo": {
    "state": "DONE",
    "errorCode": "",
    "errorMessage": "string",
    "updateTime": "2025-04-02T19:45:28.650924Z"
  }
}

We'd love to hear from you!