# Import numbers using hosting orders

Import numbers associated with hosting orders of a specific project and schedule the async provisioning to Sinch SMS platform and linking to campaign if applicable.

Note: This operation is limited to five numbers. If you want to increase the quantity of numbers you can import using this operation, please contact your account manager for authorization.

Endpoint: POST /v1/projects/{projectId}/hostingOrders:importNumbers
Version: 1.0
Security: Basic, OAuth2.0

## Path parameters:

  - `projectId` (string, required)
    Found on your Sinch Customer Dashboard. Settings > Projects.
    Example: "d1923022-5199-4bb3-a513-c47b3a656bc5"

## Request fields (application/json):

  - `regionCode` (string, required)
    The region code for the import request.
    Example: "US"

  - `numbers` (array, required)
    An array of all the phone numbers associated with the import request.
    Example: ["+12025550134"]

  - `servicePlanId` (string, required)
    The ID of the service plan to which the import request is associated.
    Example: "YOUR_service_plan_id"

  - `projectId` (string)
    The ID of the project to which the import request is associated.
    Example: "YOUR_project_id"

  - `displayName` (string)
    The optional display name of the import request.
    Example: "MyImportRequest"

  - `campaignId` (string)
    The ID of the campaign to which the request is associated.
    Example: "YOUR_campaign_id"

  - `callbackUrl` (string)
    The callback URL to be called for import numbers updates

  - `migrateToSinchTmo` (boolean)
    If a number is assigned to another aggregator in T-Mobile's platform, then T-Mobile will give an error code 60135 indicating that number needs to be “migrated” from previous aggregator to Sinch. This “migration” requires provisioning of number by setting this flag named to true for successful number linking process.

## Response 200 fields (application/json):

  - `projectId` (string)
    The project ID to which the hosting order is associated.
    Example: "YOUR_project_id"

  - `hostingOrderId` (string)
    The unique ID of the hosting order.
    Example: "YOUR_hosting_order_id"

  - `displayName` (string)
    The friendly name of the hosting order.
    Example: "MyHostingOrder"

  - `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".
    Example: "US"

  - `state` (string)
    The state of the hosting order.
    Enum: "HOSTING_ORDER_STATE_UNSPECIFIED", "DRAFT", "SUBMITTED", "WAITING_FOR_LOA_SIGNATURE", "IN_PROGRESS", "COMPLETED", "REJECTED"

  - `type` (string)
    The hosting order type.
    Enum: "HOSTING_ORDER_TYPE_UNSPECIFIED", "IMPORT", "TYPE_TEXT_ENABLE"

  - `createdTime` (string)
    Timestamp when the hosting order was created

  - `updatedTime` (string)
    Timestamp when the hosting order was last updated

  - `servicePlanId` (string)
    The service plan to which the hosting order is associated.
    Example: "YOUR_service_plan_id"

  - `campaignId` (string)
    The campaign to which the hosting order is associated.
    Example: "YOUR_campaign_id"

  - `migrateToSinchTmo` (boolean)
    Displays if a number is assigned to another aggregator in T-Mobile's platform, and requires migration from previous aggregator to Sinch.

  - `callbackUrl` (string)
    The client's callback URL to be called upon finishing the number import.
    Example: "https://www.your-callback-server.com/callback"

## Response 500 fields (application/json):

  - `code` (string)
    The HTTP response code for the error.
    Example: "404"

  - `message` (string)
    The friendly message describing the reason for the error response.
    Example: "The imported number could not be found."

  - `status` (string)
    The HTTP response status for the error.
    Example: "NOT_FOUND"