Sign in
latestOpenAPI 3.0.3MIT2026-08-102357127.0 KB

c3d50cf4681d

Qualified Numbers

Send voice challenge

Sends a voice challenge to the phone number specified in the path to verify that you own the number. The voice call contains a code that you must use to verify the number.

post/v1/projects/{projectId}/qualifiedNumbers/{phoneNumber}:sendVoiceChallenge

Path parameters

projectIdstring required
Example:d1923022-5199-4bb3-a513-c47b3a656bc5

Found on your Sinch Customer Dashboard. Settings > Projects.

phoneNumberstring required
Example:+12025550134

The phone number in E.164 format with leading +.

Response

OK

phoneNumberstring

The phone number in e.164 format with leading +.

projectIdstring

The ID of the project to which the number belongs.

regionCodestring

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.

createdTimestring date-time

The date and time the hosting order was created.

updatedTimestring date-time

The date and time the hosting order was last updated.

Example response

{
  "phoneNumber": "+12025550134",
  "projectId": "abcd12ef-ab12-ab12-bc34-abcdef123456",
  "regionCode": "US",
  "osrEligibility": {
    "status": "DONE"
  },
  "ownershipVerification": {
    "status": "DONE"
  }
}