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

# Get hosting order

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

## Request

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

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