---
title: "Get hosting order number"
method: GET
path: "/v1/projects/{projectId}/hostingOrders/{hostingOrderId}/numbers/{phoneNumber}"
tags: ["Hosting Orders"]
---

# Get hosting order number

`GET /v1/projects/{projectId}/hostingOrders/{hostingOrderId}/numbers/{phoneNumber}`

## Request

- Base URL: `https://imported.numbers.api.sinch.com`
- URL: `https://imported.numbers.api.sinch.com/v1/projects/{projectId}/hostingOrders/{hostingOrderId}/numbers/{phoneNumber}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.sinch.com/oauth2/token`

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

## Path parameters

- `projectId` string, required
- `hostingOrderId` string, required
- `phoneNumber` string, required

## Response `200`

OK

- HostingOrderNumber
  - `projectId` string: The project ID to which the number belongs.
  - `hostingOrderId` string: The ID of the hosting order to which the number belongs.
  - `phoneNumber` string: The phone number in e.164 format with leading +.
  - `osrUpdate` HostingOrderNumberOsrUpdate: An object containing information about the OSR update.
    - `nnid` string: The Net Number ID identifying the phone number.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
  - `campaignProvisioning` HostingOrderNumberCampaignProvisioning: An object containing information about campaign provisioning.
    - `campaignId` string: The campaign ID to which the hosting order is associated.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
  - `platformProvisioning` HostingOrderNumberPlatformProvisioning: An object containing information related to the provisioning on the platform.
    - `servicePlanId` string: The service plan ID to which the hosting order number is associated.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
  - `smsAtt` CarrierState: Contains information about the state of the carrier.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
    - `errorCode` string: An optional string field that contains an error code if the operation failed. This field is empty ("") when there is no error.
    - `errorMessage` string: An optional string field that provides a human-readable message describing the error. This field is empty ("") when no error has occurred.
    - `updateTime` string: A timestamp in ISO 8601 format indicating the last time the status was updated.
  - `smsTmo` CarrierState: Contains information about the state of the carrier.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
    - `errorCode` string: An optional string field that contains an error code if the operation failed. This field is empty ("") when there is no error.
    - `errorMessage` string: An optional string field that provides a human-readable message describing the error. This field is empty ("") when no error has occurred.
    - `updateTime` string: A timestamp in ISO 8601 format indicating the last time the status was updated.
  - `mmsAtt` CarrierState: Contains information about the state of the carrier.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
    - `errorCode` string: An optional string field that contains an error code if the operation failed. This field is empty ("") when there is no error.
    - `errorMessage` string: An optional string field that provides a human-readable message describing the error. This field is empty ("") when no error has occurred.
    - `updateTime` string: A timestamp in ISO 8601 format indicating the last time the status was updated.
  - `mmsTmo` CarrierState: Contains information about the state of the carrier.
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED': Indicates the current state of the operation.
    - `errorCode` string: An optional string field that contains an error code if the operation failed. This field is empty ("") when there is no error.
    - `errorMessage` string: An optional string field that provides a human-readable message describing the error. This field is empty ("") when no error has occurred.
    - `updateTime` string: A timestamp in ISO 8601 format indicating the last time the status was updated.

## Other responses

- `404`: NOT FOUND: The resource could not be found.
- `500`: INTERNAL: Internal server error. Typically, a server bug.

---

[API](https://skmtc.dev/sinch/apis/imported-numbers-and-hosting-orders.md) - [All operations](https://skmtc.dev/sinch/apis/imported-numbers-and-hosting-orders/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/imported-numbers-and-hosting-orders/revisions/c3d50cf4681d?raw)