ProvisioningStatus by ComplianceRegistration and PhoneNumber resource

(new)

Private Beta

ProvisioningStatus resources are currently available as a Private Beta product and the information contained in this document is subject to change. This means that some features aren't yet implemented and others may be changed before the product is declared as Generally Available. Private Beta products aren't covered by a SLA.

The ProvisioningStatus by ComplianceRegistration and PhoneNumber resource lets you retrieve the provisioning status for a phone number within a Voice Trust Bundle. You can view detailed carrier-level provisioning information.

Retrieve provisioning status by ComplianceRegistration and PhoneNumber

GET https://voice.twilio.com/v2/ComplianceRegistrations/{complianceRegistrationSid}/PhoneNumbers/{pnSidOrDid}/ProvisioningStatus

Path parameters

Name	Type	Required	Description	PII
`complianceRegistrationSid`	string	Yes	The SID of the Voice Trust Bundle.	Not PII
`pnSidOrDid`	string	Yes	The phone number in E.164 format or the SID of the phone number.	Not PII

(information)

Info

The ProvisioningStatus of the phone number is an aggregate of the statuses across all carriers listed in the Carriers array. For example:

If all carrier statuses are active, the overall ProvisioningStatus is TWILIO_APPROVED.
If one or more carriers have a status of IN_PROGRESS or REJECTED, the aggregated ProvisioningStatus reflects IN_PROGRESS or TWILIO_REJECTED accordingly.

Retrieve the phone number provisioning status by phone number and compliance registration

1curl -X GET "https://voice.twilio.com/v2/ComplianceRegistrations/{complianceRegistrationSid}/PhoneNumbers/{pnSidOrDid}/ProvisioningStatus" \
2    -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3  "bundle_sid": "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
4  "carriers": [
5    {
6      "carrier_errors": [],
7      "carrier_name": "T-Mobile",
8      "carrier_status": "rejected",
9      "date_created": "2025-09-04T06:07:16Z",
10      "date_updated": "2025-09-04T06:07:16Z"
11    },
12    {
13      "carrier_errors": [],
14      "carrier_name": "AT&T",
15      "carrier_status": "active",
16      "date_created": "2025-09-04T06:07:16Z",
17      "date_updated": "2025-09-04T06:07:16Z"
18    }
19  ],
20  "errors": [],
21  "phone_number": "+13309440913",
22  "pn_sid": "PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
23  "provisioning_status": "TWILIO_REJECTED",
24  "provisioning_type": "US Voice Integrity",
25  "regulation_sid": "RN5b3660f9598883b1df4e77f77acefba0"
26}