--- title: "List imported numbers" method: GET path: "/v1/projects/{projectId}/importedNumbers" tags: ["Imported Numbers"] --- # List imported numbers `GET /v1/projects/{projectId}/importedNumbers` Lists all imported numbers for the project. ## Path parameters - `projectId` string, required ## Query parameters - `regionCode` string - `numberPattern.pattern` string - `numberPattern.searchPattern` 'START' | 'CONTAIN' | 'END' - `pageSize` integer - `pageToken` string - `orderBy` 'createdTime' | 'updatedTime' - `servicePlanId` string, required - `campaignId` string, required ## Response `200` OK - ListImportedNumbersResponse — Response message to list your imported phone numbers - `importedNumbers` ImportedNumberResponse[] — List of numbers associated to the client project specified in `ListImportedNumbers`. - `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. - `nextPageToken` string — The token to be used for listing the next page. - `totalSize` integer — https://cloud.google.com/apis/design/design_patterns#list_pagination ## Other responses - `400` — If the page_token, number_pattern or order_by is not valid. - `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)