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

# List hosting orders

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

## Request

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

Lists the hosting orders for the project.

## Path parameters

- `projectId` string, required

## Query parameters

- `regionCode` string
- `states` 'HOSTING_ORDER_STATE_UNSPECIFIED' | 'DRAFT' | 'SUBMITTED' | 'WAITING_FOR_LOA_SIGNATURE' | 'IN_PROGRESS' | 'COMPLETED' | 'REJECTED', required
- `type` 'HOSTING_ORDER_TYPE_UNSPECIFIED' | 'IMPORT' | 'TYPE_TEXT_ENABLE', required
- `servicePlanId` string, required
- `campaignId` string, required
- `orderBy` 'createdTime' | 'updatedTime'
- `pageToken` string
- `pageSize` integer

## Response `200`

OK

- ListHostingOrdersResponse
  - `hostingOrders` 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.
  - `nextPageToken` string
  - `totalSize` integer

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