---
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}`

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.net/sinch/apis/imported-numbers-and-hosting-orders.md) · [All operations](https://skmtc.net/sinch/apis/imported-numbers-and-hosting-orders/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/imported-numbers-and-hosting-orders/revisions/c3d50cf4681d/schema)