---
title: "Create qualified number batch"
method: POST
path: "/v1/projects/{projectId}/qualifiedNumbers:addNumbers"
tags: ["Qualified Numbers"]
---

# Create qualified number batch

`POST /v1/projects/{projectId}/qualifiedNumbers:addNumbers`

Create a request to qualify a batch of numbers. After you have submitted the request, you must send an email to orders@sinch.com attaching all of the invoices related to the phone numbers in the request. In most cases, it will take the Sinch team 1-3 days to review your documentation and qualify your numbers.

## Path parameters

- `projectId` string, required

## Request body

- BatchCreateQualifiedNumbersRequest — The phone numbers you want to qualify.
  - `phoneNumbers` string[], required

## Response `200`

OK

- BatchCreateQualifiedNumbersResponse
  - `qualifiedNumbers` QualifiedNumber[]
    - `phoneNumber` string — The phone number in e.164 format with leading +.
    - `projectId` string — The ID of the project to which the number belongs.
    - `regionCode` string — ISO 3166-1 alpha-2 country code of the phone number. Example US or CA.
    - `globalProcessState` 'GLOBAL_PROCESS_STATE_UNSPECIFIED' | 'GLOBAL_PROCESS_STATE_ELIGIBLE_CHECK_PENDING' | 'GLOBAL_PROCESS_STATE_ELIGIBLE' | 'GLOBAL_PROCESS_STATE_NOT_ELIGIBLE' | 'GLOBAL_PROCESS_STATE_VERIFICATION_PENDING' | 'GLOBAL_PROCESS_STATE_VERIFICATION_FAILED' | 'GLOBAL_PROCESS_STATE_VERIFICATION_BLOCKED' | 'GLOBAL_PROCESS_STATE_VERIFIED' | 'GLOBAL_PROCESS_STATE_HOSTING_IN_PROGRESS' | 'GLOBAL_PROCESS_STATE_HOSTING_DONE' | 'GLOBAL_PROCESS_STATE_HOSTING_FAILED', enum — The global processing state of the qualified number.
    - `osrEligibility` QualifiedNumberOsrEligibilityDetails — Details about the OSR eligibility, including the status of the OSR update, and the error if available.
      - `status` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED' — Indicates the current state of the operation.
      - `error` string
    - `ownershipVerification` QualifiedNumberOwnershipVerificationDetails — Details about the ownership verification, including the status of the verification process and any error if available.
      - `status` 'DONE' | 'FAILED' | 'IN_PROGRESS' | 'WAITING' | 'STATE_UNSPECIFIED' — Indicates the current state of the operation.
      - `error` string
    - `hostedNumber` QualifiedNumberHostedNumberDetails — Details about the hosting status of a number, including any errors if available.
      - `status` 0 | 1 | 2 — The status of the hosting details.
      - `error` string — The description of the hosting status error.
    - `createdTime` string, date-time — The date and time the hosting order was created.
    - `updatedTime` string, date-time — The date and time the hosting order was last updated.

## Other responses

- `404` — NOT FOUND: The resource 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)