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

# Get hosting order

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

Returns the hosting order specified by the hosting order ID.

## Path parameters

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

## Response `200`

OK

- HostingOrder
  - `projectId` string — The project ID to which the hosting order is associated.
  - `hostingOrderId` string — The unique ID of the hosting order.
  - `displayName` string — The friendly name of the hosting order.
  - `regionCode` string — The region code of the hosting order. Number hosting is only available for the US and Canada, so you must enter either "US" or "CA".
  - `state` 'HOSTING_ORDER_STATE_UNSPECIFIED' | 'DRAFT' | 'SUBMITTED' | 'WAITING_FOR_LOA_SIGNATURE' | 'IN_PROGRESS' | 'COMPLETED' | 'REJECTED' — The state of the hosting order.
  - `type` 'HOSTING_ORDER_TYPE_UNSPECIFIED' | 'IMPORT' | 'TYPE_TEXT_ENABLE' — The hosting order type.
  - `createdTime` string, date-time — Timestamp when the hosting order was created
  - `updatedTime` string, date-time — Timestamp when the hosting order was last updated
  - `scheduledOsrUpdateTime` string, date-time — Timestamp when the OSR update will be done
  - `servicePlanId` string — The service plan to which the hosting order is associated.
  - `campaignId` string — The campaign to which the hosting order is associated.
  - `migrateToSinchTmo` boolean — Displays if a number is assigned to another aggregator in T-Mobile's platform, and requires migration from previous aggregator to Sinch.
  - `textEnableInfo` TextEnableInfo
    - `businessName` string — The name of the business.
    - `authorisedPerson` AuthorizedPerson — The person authorized and responsible for the hosting order.
      - `firstName` string, required — The first name of the authorized person.
      - `lastName` string, required — The last name of the authorized person.
      - `email` string, required — The email address of the authorized person.
    - `address` Address — The address of the business.
      - `buildingNumber` string, required — The building number of the address.
      - `street` string, required — The street name of the address.
      - `city` string, required — The city name of the address.
      - `state` string, required — The state name of the address.
      - `postalCode` string, required — The postal code of the address.
      - `country` string, required — The country of the address.
    - `serviceProvider` string
    - `currentVoiceCarrier` string — The current carrier you are using for voice services for the number you want to host on Sinch.
    - `nnid` string — The Net Number ID for the number you want to host on Sinch.
    - `loaType` 'Direct' | 'Reseller', enum — The type of the letter of authorization.
  - `callbackUrl` string — The client's callback URL to be called upon finishing the number import.

## 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)