---
title: "Get qualified number"
method: GET
path: "/v1/projects/{projectId}/qualifiedNumbers/{phoneNumber}"
tags: ["Qualified Numbers"]
---

# Get qualified number

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

Return a qualified number as specified by the phone number in the path.

## Path parameters

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

## Response `200`

OK

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