---
title: "Get imported number"
method: GET
path: "/v1/projects/{projectId}/importedNumbers/{phoneNumber}"
tags: ["Imported Numbers"]
---

# Get imported number

`GET /v1/projects/{projectId}/importedNumbers/{phoneNumber}`

Returns the imported number you specify in the path.

## Path parameters

- `projectId` string, required
- `phoneNumber` string, required

## Response `200`

OK

- ImportedNumberResponse — An object giving details about the campaign provisioning of the number.
  - `phoneNumber` string — The phone number in e.164 format with leading +.
  - `projectId` string — The ID of the project resource. You can find your project ID on dashboard.sinch.com.
  - `regionCode` string — ISO 3166-1 alpha-2 country code of the phone number. Example US, UK or SE.
  - `displayName` string — User supplied name for the phone number.
  - `smsConfiguration` SmsConfiguration — Configuration for SMS
    - `servicePlanId` string — The current SMS configuration for this number. The `servicePlanId`` can be found when logging into dashboard.sinch.com in the SMS>APIs section.
    - `scheduledProvisioning` ScheduledProvisioning — Ongoing Provisioning for SMS service
      - `servicePlanId` string — Service plan of the scheduled provisioning task.
      - `status` integer — Status of the pending change.
      - `lastUpdatedTime` string, date-time — Timestamp when the status was last updated.
      - `campaignId` string — The campaign of the scheduled provisioning task.
      - `errorCodes` integer[] — A list of error codes, if applicable, for the scheduled provisioning task.
    - `campaignId` string — The current campaign ID assigned to this number.
    - `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.
  - `mnoConfiguration` object — The mnoConfiguration object represents the status and progress of configuration operations for SMS and MMS services across different carriers (AT&T and T-Mobile). Each key within this object (smsAtt, smsTmo, mmsAtt and mmsTmo) corresponds to a specific service type (SMS or MMS) associated with a particular mobile network operator.
    - `smsAtt` object — 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.
      - `operation` 'PROVISIONING' | 'DEPROVISIONING' | 'OPERATION_UNSPECIFIED' — Specifies the type of action being performed.
    - `smsTmo` object — 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.
      - `operation` 'PROVISIONING' | 'DEPROVISIONING' | 'OPERATION_UNSPECIFIED' — Specifies the type of action being performed.
    - `mmsAtt` object — 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.
      - `operation` 'PROVISIONING' | 'DEPROVISIONING' | 'OPERATION_UNSPECIFIED' — Specifies the type of action being performed.
    - `mmsTmo` object — 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.
      - `operation` 'PROVISIONING' | 'DEPROVISIONING' | 'OPERATION_UNSPECIFIED' — Specifies the type of action being performed.
  - `smsProvisioning` object — An object giving details about the SMS provisioning of the number.
    - `serviceType` 'SMS' | 'CAMPAIGN' — The type of service.
    - `serviceId` string — A unique identifier for the service being provisioned.
    - `type` 'PROVISIONING' | 'DEPROVISIONING' — Specifies the type of operation. This value of this field is either "PROVISIONING" or "DEPROVISIONING".
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED' — Indicates the current state of the operation.
    - `updateTime` string — A timestamp in ISO 8601 format (UTC) indicating the last time the provisioning status was updated.
    - `errorMessage` string — If an error occurred during provisioning, this field will contain a descriptive message. It will be an empty string if no error is present.
    - `errorCode` string — If an error occurred during provisioning, this field will contain the error code. This field is also an empty string when no error has occurred.
  - `campaignProvisioning` object — An object giving details about the campaign provisioning of the number.
    - `serviceType` 'SMS' | 'CAMPAIGN' — The type of service.
    - `serviceId` string — A unique identifier for the service being provisioned.
    - `type` 'PROVISIONING' | 'DEPROVISIONING' — Specifies the type of operation. This value of this field is either "PROVISIONING" or "DEPROVISIONING".
    - `state` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED' — Indicates the current state of the operation.
    - `updateTime` string — A timestamp in ISO 8601 format (UTC) indicating the last time the provisioning status was updated.
    - `errorMessage` string — If an error occurred during provisioning, this field will contain a descriptive message. It will be an empty string if no error is present.
    - `errorCode` string — If an error occurred during provisioning, this field will contain the error code. This field is also an empty string when no error has occurred.

## Other responses

- `404` — The imported number 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)