Onboard customers to Branded Calling using the Trust Hub API

Learn how to programmatically onboard your Independent Software Vendor (ISV) customers to Branded Calling by executing GET, POST, and PATCH requests on the Twilio Trust Hub API. You can use this guide to implement branded messaging and calling for voice notifications, outbound call centers, and sales dialers.

See Related reference documentation to learn more about the Trust Hub API resources used in this guide.

(new)

Private beta

The Trust Hub API resources for Branded Calling are in private beta, 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 Service Level Agreement (SLA).

To request access, complete the request form.

Trust Hub API resources for Branded Calling

Compliance Regulations resource: The compliance requirements for Branded Calling in a specific country or type. Each Regulation specifies the required data fields, supporting documents, and validations.
Compliance Registrations resource: A submission of required compliance data for a specific regulation and brand (Branded Calling bundle). It includes brand assets, tracks review and approval status, and enables associated phone numbers to display the brand information on the called party's mobile phone.
- ResourceAssignments subresource: A Twilio phone number assigned to a verified Compliance Registration. ResourceAssignments is a subresource of the Compliance Registrations resource.
Compliance Documents resource: A Letter of Authorization (LOA) required for compliance verification. Customers must provide a signed LOA for their brand.
Compliance DocumentLinks resource: A link that associates a LOA with a Compliance Registration.

Onboarding process

To onboard your customer to Branded Calling, you'll do the following:

Complete the prerequisites.
Retrieve the Compliance Regulation for Branded Calling: Retrieve the latest country-specific requirements to see what information and documents you need before submitting your Compliance Registration.
Create a Compliance Registration: Create a Compliance Registration and set up the brand's registration profile. Include all required information for review and approval.
Upload a signed LOA: Upload the LOA signed by your customer for compliance verification.
Link the LOA to the Compliance Registration: Link the uploaded LOA with the Compliance Registration you created.
Assign a phone number to the Compliance Registration: Assign a phone number that will display the brand information once the Compliance Registration is approved.
Submit the Compliance Registration for review: Submit the Compliance Registration for review. Twilio and carrier partners will verify the information provided.
(Optional) Retrieve the submission status: Track the status of your submission (approved, rejected, in review).

Review process after submission

When you submit your Compliance Registration, the review process follows these steps:

Twilio reviews your submission and contacts you by email if you need to provide corrections or additional details to complete the approval process. You can track the current status of your submission by making an API request or checking the Twilio Console.
After Twilio vets and approves your information, Twilio submits it to the carrier partner for secondary review and provisioning.
After successful secondary review and provisioning, your phone numbers become active for Branded Calling, and recipients begin to see your brand information.

The review process takes about seven business days.

Prerequisites

Create a primary Business Profile and have it approved.
For Basic Branded Calling, create a Voice Integrity and have it approved. Voice Integrity lets you register your phone numbers with analytic vendors to reduce spam labeling. Learn more about how to onboard Voice Integrity.
Download the LOA template and obtain a signed LOA from your customer.
Have an Address SID.
An Address resource represents the physical address of your business. You'll use the Address SID when creating a Compliance Registration (address.id). You can create or retrieve an existing Address SID by using the Addresses resource.

Retrieve the Compliance Regulation for Branded Calling

GET https://trusthub.twilio.com/v4/Compliance/Regulations/{id}

To retrieve the latest country-specific requirements, make a GET request to the Compliance Regulation resource with its Regulation ID. You can specify the version query parameter to get a specific version of the Regulation.

Branded Calling type	Country	Regulation ID	Latest version
US Basic	`US` (United States)	`RNca63d1066fbd5e44eac02d0b3cf6d019`	`13`
US Enhanced	`US` (United States)	`RNa0b74679be7511921f4d2e3094fa6d23`	`9`
Non-US	`GB` (United Kingdom)	`RN304faa2408f673b68867fe5cb65b7f50`	`4`
Non-US	`DE` (Germany)	`RN5db7f1c57f6157280b28428ede4db708`	`4`
Non-US	`CA` (Canada)	`RNa5150dedb5f110adba478ce9dde61d56`	`4`

US Basic Branded CallingUS Enhanced Branded CallingNon-US Branded Calling

US Basic Branded Calling: Retrieve the Compliance Regulation

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Regulations/RNca63d1066fbd5e44eac02d0b3cf6d019' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "country": "US",
3  "endUserType": "BUSINESS",
4  "friendlyName": "Basic Branded Calling - US",
5  "id": "RNca63d1066fbd5e44eac02d0b3cf6d019",
6  "schema": {
7    "$schema": "http://json-schema.org/draft-07/schema#",
8    "additionalProperties": false,
9    "properties": {
10      "brandedCaller": {
11        "additionalProperties": false,
12        "properties": {
13          "displayLongName": {
14            "description": "An optional longer display name for supported carriers. This should align with your primary display name. Limit 32 characters (including spaces), should always start with a letter and can only contain letters, numbers, periods, commas and spaces.",
15            "maxLength": 32,
16            "minLength": 1,
17            "pattern": "^[a-zA-Z][A-Za-z0-9,.\\s]{1,31}$",
18            "title": "Branded Calls Long Display Name",
19            "type": [
20              "string",
21              "null"
22            ]
23          },
24          "displayName": {
25            "description": "The display name to be shown on the terminating handset for outbound calls. The display name can be up to 15 characters (including spaces), should always start with a letter and can only contain letters, numbers, periods, commas and spaces.",
26            "maxLength": 15,
27            "minLength": 1,
28            "pattern": "^[a-zA-Z][A-Za-z0-9,.\\s]{1,14}$",
29            "title": "Branded Calls Display Name",
30            "type": "string"
31          },
32          "voiceIntegrityRegistrationId": {
33            "description": "The registration id of the associated voice integrity registration.",
34            "maxLength": 34,
35            "minLength": 34,
36            "pattern": "^BU[0-9a-fA-F]{32}$",
37            "title": "Voice Integrity Registration Id",
38            "type": "string"
39          }
40        },
41        "required": [
42          "displayName"
43        ],
44        "type": "object"
45      }
46    },
47    "required": [
48      "brandedCaller"
49    ],
50    "title": "Basic Branded Calling - US",
51    "type": "object",
52    "x-acceptableDocuments": [
53      {
54        "description": "The letter to authorize Twilio to run voice traffic on a given set of Phone Numbers.",
55        "documents": [
56          {
57            "description": "Letter of Authorization containing Brand Name, Tax ID, Tax country, Legal Name, Address, Phone #",
58            "documentType": "letter_of_authorization",
59            "friendlyName": "Letter of Authorization"
60          }
61        ],
62        "friendlyName": "Letter of Authorization"
63      }
64    ]
65  },
66  "subType": "BRANDED_CALLS",
67  "type": "VOICE_TRUST",
68  "version": 13
69}

US Enhanced Branded Calling: Retrieve the Compliance Regulation

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Regulations/RNa0b74679be7511921f4d2e3094fa6d23' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "country": "US",
3  "endUserType": "BUSINESS",
4  "friendlyName": "Enhanced Branded Calling - US",
5  "id": "RNa0b74679be7511921f4d2e3094fa6d23",
6  "schema": {
7    "$schema": "http://json-schema.org/draft-07/schema#",
8    "additionalProperties": false,
9    "properties": {
10      "address": {
11        "additionalProperties": false,
12        "description": "Physical address of your business.",
13        "properties": {
14          "id": {
15            "description": "Must be a valid address",
16            "maxLength": 34,
17            "minLength": 34,
18            "pattern": "^AD[0-9a-fA-F]{32}$",
19            "title": "Address id",
20            "type": "string"
21          }
22        },
23        "required": [
24          "id"
25        ],
26        "type": "object"
27      },
28      "authorizedContact": {
29        "additionalProperties": false,
30        "description": "If you are an ISV registering for Branded Calling on behalf of an end user, please ensure the brand contact is an individual from the end user's company.",
31        "properties": {
32          "firstName": {
33            "description": "The first name of the authorized contact.",
34            "minLength": 1,
35            "title": "First Name",
36            "type": "string"
37          },
38          "lastName": {
39            "description": "The last name of the authorized contact.",
40            "minLength": 1,
41            "title": "Last Name",
42            "type": "string"
43          },
44          "mobilePhoneE164": {
45            "description": "The mobile phone number of the authorized contact.",
46            "pattern": "^\\+[1-9]\\d{1,14}$",
47            "title": "Mobile Phone Number",
48            "type": "string"
49          },
50          "verificationEmail": {
51            "description": "The verification email address of the authorized contact.",
52            "format": "email",
53            "minLength": 1,
54            "pattern": "^\\S+@\\S+\\.\\S+$",
55            "title": "Verification Email Address",
56            "type": "string"
57          }
58        },
59        "required": [
60          "firstName",
61          "lastName",
62          "verificationEmail",
63          "mobilePhoneE164"
64        ],
65        "type": "object"
66      },
67      "authorizedRepresentative1": {
68        "additionalProperties": false,
69        "description": "Authorized Representative #1",
70        "properties": {
71          "email": {
72            "description": "The email address of the authorized representative.",
73            "format": "email",
74            "minLength": 1,
75            "pattern": "^\\S+@\\S+\\.\\S+$",
76            "title": "Email Address",
77            "type": "string"
78          },
79          "firstName": {
80            "description": "The first name of the authorized representative.",
81            "minLength": 1,
82            "title": "First Name",
83            "type": "string"
84          },
85          "jobPosition": {
86            "description": "The job position of the authorized representative.",
87            "enum": [
88              "Director",
89              "GM",
90              "VP",
91              "CEO",
92              "CFO",
93              "General Counsel",
94              "Other"
95            ],
96            "title": "Job Position",
97            "type": "string"
98          },
99          "lastName": {
100            "description": "The last name of the authorized representative.",
101            "minLength": 1,
102            "title": "Last Name",
103            "type": "string"
104          },
105          "phoneE164": {
106            "description": "The phone number of the authorized representative.",
107            "minLength": 1,
108            "pattern": "^\\+[1-9]\\d{1,14}$",
109            "title": "Phone Number",
110            "type": "string"
111          }
112        },
113        "required": [
114          "firstName",
115          "lastName",
116          "email",
117          "phoneE164",
118          "jobPosition"
119        ],
120        "type": "object"
121      },
122      "brandedCaller": {
123        "additionalProperties": false,
124        "description": "The information that will be shown on the terminating handset for outbound calls.",
125        "properties": {
126          "displayCallReason": {
127            "description": "The call reason to be shown on the terminating handset for outbound calls. Limit 64 characters.",
128            "maxLength": 64,
129            "minLength": 1,
130            "title": "Branded Calls Call Reason",
131            "type": [
132              "string",
133              "null"
134            ]
135          },
136          "displayLogoUrl": {
137            "description": "The URL of the logo to be shown on the terminating handset for outbound calls. Only bmp, png types are supported",
138            "format": "uri",
139            "pattern": "^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?:[Ww]{3}\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&/=]*)$",
140            "title": "Branded Calls Logo URL",
141            "type": [
142              "string",
143              "null"
144            ]
145          },
146          "displayName": {
147            "description": "The display name to be shown on the terminating handset for outbound calls. The display name can be up to 35 characters.",
148            "maxLength": 35,
149            "minLength": 1,
150            "title": "Branded Calls Display Name",
151            "type": "string"
152          }
153        },
154        "required": [
155          "displayName"
156        ],
157        "type": "object"
158      },
159      "business": {
160        "additionalProperties": false,
161        "description": "General business information",
162        "properties": {
163          "employeeCount": {
164            "description": "The number of employees in the business.",
165            "minimum": 1,
166            "title": "Business Employee Count",
167            "type": "integer"
168          },
169          "entityType": {
170            "description": "Business type can be empty or one of Sole Proprietorship, Partnership, Co-operative, Limited Liability Corporation, Non-profit Corporation, Corporation",
171            "enum": [
172              "Sole Proprietorship",
173              "Partnership",
174              "Limited Liability Corporation",
175              "Co-operative",
176              "Non-profit Corporation",
177              "Corporation"
178            ],
179            "title": "Business Type",
180            "type": "string"
181          },
182          "identityType": {
183            "description": "Whether the company is an ISV (independent software vendor) or direct customer.",
184            "enum": [
185              "direct_customer",
186              "isv_reseller_or_partner"
187            ],
188            "title": "Business Identity (ISV vs. Direct)",
189            "type": "string"
190          },
191          "industry": {
192            "description": "Business industry should be one of AGRICULTURE, COMMUNICATION, CONSTRUCTION, EDUCATION, ENERGY, ENTERTAINMENT, FINANCIAL, GAMBLING, GOVERNMENT, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, LEGAL, MANUFACTURING, NGO, POLITICAL, POSTAL, PROFESSIONAL, REAL_ESTATE, RETAIL, TECHNOLOGY, TRANSPORTATION",
193            "enum": [
194              "AUTOMOTIVE",
195              "AGRICULTURE",
196              "BANKING",
197              "CONSTRUCTION",
198              "CONSUMER",
199              "EDUCATION",
200              "ENGINEERING",
201              "ENERGY",
202              "OIL_AND_GAS",
203              "FAST_MOVING_CONSUMER_GOODS",
204              "FINANCIAL",
205              "FINTECH",
206              "FOOD_AND_BEVERAGE",
207              "GOVERNMENT",
208              "HEALTHCARE",
209              "HOSPITALITY",
210              "INSURANCE",
211              "LEGAL",
212              "MANUFACTURING",
213              "MEDIA",
214              "ONLINE",
215              "PROFESSIONAL_SERVICES",
216              "RAW_MATERIALS",
217              "REAL_ESTATE",
218              "RELIGION",
219              "RETAIL",
220              "JEWELRY",
221              "TECHNOLOGY",
222              "TELECOMMUNICATIONS",
223              "TRANSPORTATION",
224              "TRAVEL",
225              "ELECTRONICS",
226              "NOT_FOR_PROFIT"
227            ],
228            "title": "Business Industry",
229            "type": "string"
230          },
231          "isSubassigned": {
232            "description": "Choose any one of the following values : [YES, NO]. A sub assigned phone number is where Independent Software Vendor (ISV) assigns the Twilio phone number to their end customer. If you are a direct customer, answer NO.",
233            "enum": [
234              "YES",
235              "NO"
236            ],
237            "title": "Will you subassign this number to your end customers?",
238            "type": "string"
239          },
240          "legalName": {
241            "description": "Name of the business entity",
242            "maxLength": 255,
243            "minLength": 1,
244            "title": "Business Name",
245            "type": "string"
246          },
247          "privacyNoticeUrl": {
248            "description": "The privacy notice/policy website that explains how the business collects, uses, and protects personal data.",
249            "format": "uri",
250            "pattern": "^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?:[Ww]{3}\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&/=]*)$",
251            "title": "Privacy Notice URL",
252            "type": [
253              "string",
254              "null"
255            ]
256          },
257          "registrationAuthority": {
258            "description": "The registrar the business is registered with: EIN(US), DUNS",
259            "enum": [
260              "EIN",
261              "DUNS"
262            ],
263            "title": "Business Registration Identifier",
264            "type": "string"
265          },
266          "registrationNumber": {
267            "description": "The ID number of the business in the business registrar",
268            "maxLength": 21,
269            "minLength": 1,
270            "title": "Business Registration Number",
271            "type": "string"
272          },
273          "tradeName": {
274            "description": "The trade name or DBA name that the business uses to operate under that is different than the legal name.",
275            "maxLength": 255,
276            "minLength": 1,
277            "title": "Business Trade Name",
278            "type": [
279              "string",
280              "null"
281            ]
282          },
283          "websiteUrl": {
284            "description": "The URL of the business website",
285            "format": "uri",
286            "minLength": 1,
287            "pattern": "^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?:[Ww]{3}\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&/=]*)$",
288            "title": "Website URL",
289            "type": "string"
290          }
291        },
292        "required": [
293          "legalName",
294          "entityType",
295          "identityType",
296          "registrationNumber",
297          "registrationAuthority",
298          "industry",
299          "websiteUrl",
300          "isSubassigned",
301          "employeeCount"
302        ],
303        "type": "object"
304      },
305      "useCase": {
306        "additionalProperties": false,
307        "description": "What the branded calling products will be used for.",
308        "properties": {
309          "callVolumeDaily": {
310            "description": "The number of calls expected to be placed per day.",
311            "minimum": 1,
312            "title": "Call Volume Daily",
313            "type": "integer"
314          },
315          "category": {
316            "description": "The branded calling use case category.",
317            "enum": [
318              "2FA",
319              "ACCOUNT_NOTIFICATION",
320              "AGENTS_FRANCHISES",
321              "CARRIER_EXEMPT",
322              "CHARITY",
323              "CUSTOMER_CARE",
324              "DELIVERY_NOTIFICATION",
325              "EMERGENCY",
326              "FRAUD_ALERT",
327              "HIGHER_EDUCATION",
328              "K12_EDUCATION",
329              "LOW_VOLUME",
330              "MARKETING",
331              "MIXED",
332              "POLITICAL",
333              "POLLING_VOTING",
334              "PROXY",
335              "PUBLIC_SERVICE_ANNOUNCEMENT",
336              "SECURITY_ALERT",
337              "SOCIAL",
338              "SOLE_PROPRIETOR",
339              "SWEEPSTAKE"
340            ],
341            "title": "Use Case Category",
342            "type": "string"
343          },
344          "categoryApple": {
345            "description": "The branded calling Apple business connect use case category.",
346            "minLength": 1,
347            "title": "Apple Business Connect Use Case Category",
348            "type": [
349              "string",
350              "null"
351            ]
352          },
353          "consentDescription": {
354            "description": "The branded calling consent use case description.",
355            "minLength": 1,
356            "title": "Use Case Consent Description",
357            "type": "string"
358          },
359          "description": {
360            "description": "The branded calling use case description.",
361            "minLength": 1,
362            "title": "Use Case Description",
363            "type": "string"
364          }
365        },
366        "required": [
367          "category",
368          "description",
369          "consentDescription",
370          "callVolumeDaily"
371        ],
372        "type": "object"
373      }
374    },
375    "required": [
376      "brandedCaller",
377      "authorizedRepresentative1",
378      "business",
379      "useCase",
380      "address"
381    ],
382    "title": "Enhanced Branded Calling - US",
383    "type": "object",
384    "x-acceptableDocuments": [
385      {
386        "description": "The letter to authorize Twilio to run voice traffic on a given set of Phone Numbers.",
387        "documents": [
388          {
389            "description": "Letter of Authorization containing Brand Name, Tax ID, Tax country, Legal Name, Address, Phone #",
390            "documentType": "letter_of_authorization",
391            "friendlyName": "Letter of Authorization"
392          }
393        ],
394        "friendlyName": "Letter of Authorization"
395      }
396    ]
397  },
398  "subType": "BRANDED_CALLS",
399  "type": "VOICE_TRUST",
400  "version": 9
401}

The following example is for the United Kingdom (country: GB).

Non-US Branded Calling (UK): Retrieve the Compliance Regulation

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Regulations/RN304faa2408f673b68867fe5cb65b7f50' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "country": "GB",
3  "endUserType": "BUSINESS",
4  "friendlyName": "Branded Calling - UK",
5  "id": "RN304faa2408f673b68867fe5cb65b7f50",
6  "schema": {
7    "$schema": "http://json-schema.org/draft-07/schema#",
8    "additionalProperties": false,
9    "properties": {
10      "address": {
11        "additionalProperties": false,
12        "description": "Physical address of your business.",
13        "properties": {
14          "id": {
15            "description": "Must be a valid address",
16            "maxLength": 34,
17            "minLength": 34,
18            "pattern": "^AD[0-9a-fA-F]{32}$",
19            "title": "Address id",
20            "type": "string"
21          }
22        },
23        "required": [
24          "id"
25        ],
26        "type": "object"
27      },
28      "authorizedContact": {
29        "additionalProperties": false,
30        "description": "If you are an ISV registering for Branded Calling on behalf of an end user, please ensure the brand contact is an individual from the end user's company.",
31        "properties": {
32          "firstName": {
33            "description": "The first name of the authorized contact.",
34            "minLength": 1,
35            "title": "First Name",
36            "type": "string"
37          },
38          "lastName": {
39            "description": "The last name of the authorized contact.",
40            "minLength": 1,
41            "title": "Last Name",
42            "type": "string"
43          },
44          "mobilePhoneE164": {
45            "description": "The mobile phone number of the authorized contact.",
46            "pattern": "^\\+[1-9]\\d{1,14}$",
47            "title": "Mobile Phone Number",
48            "type": "string"
49          },
50          "verificationEmail": {
51            "description": "The verification email address of the authorized contact.",
52            "format": "email",
53            "minLength": 1,
54            "pattern": "^\\S+@\\S+\\.\\S+$",
55            "title": "Verification Email Address",
56            "type": "string"
57          }
58        },
59        "required": [
60          "firstName",
61          "lastName",
62          "verificationEmail",
63          "mobilePhoneE164"
64        ],
65        "type": "object"
66      },
67      "authorizedRepresentative1": {
68        "additionalProperties": false,
69        "description": "Authorized Representative #1",
70        "properties": {
71          "email": {
72            "description": "The email address of the authorized representative.",
73            "format": "email",
74            "minLength": 1,
75            "pattern": "^\\S+@\\S+\\.\\S+$",
76            "title": "Email Address",
77            "type": "string"
78          },
79          "firstName": {
80            "description": "The first name of the authorized representative.",
81            "minLength": 1,
82            "title": "First Name",
83            "type": "string"
84          },
85          "jobPosition": {
86            "description": "The job position of the authorized representative.",
87            "enum": [
88              "Director",
89              "GM",
90              "VP",
91              "CEO",
92              "CFO",
93              "General Counsel",
94              "Other"
95            ],
96            "title": "Job Position",
97            "type": "string"
98          },
99          "lastName": {
100            "description": "The last name of the authorized representative.",
101            "minLength": 1,
102            "title": "Last Name",
103            "type": "string"
104          },
105          "phoneE164": {
106            "description": "The phone number of the authorized representative.",
107            "minLength": 1,
108            "pattern": "^\\+[1-9]\\d{1,14}$",
109            "title": "Phone Number",
110            "type": "string"
111          }
112        },
113        "required": [
114          "firstName",
115          "lastName",
116          "email",
117          "phoneE164",
118          "jobPosition"
119        ],
120        "type": "object"
121      },
122      "brandedCaller": {
123        "additionalProperties": false,
124        "description": "The information that will be shown on the terminating handset for outbound calls.",
125        "properties": {
126          "displayName": {
127            "description": "The display name to be shown on the terminating handset for outbound calls. The display name can be up to 32 characters.",
128            "maxLength": 32,
129            "minLength": 1,
130            "title": "Branded Calls Display Name",
131            "type": "string"
132          }
133        },
134        "required": [
135          "displayName"
136        ],
137        "type": "object"
138      },
139      "business": {
140        "additionalProperties": false,
141        "description": "General business information",
142        "properties": {
143          "employeeCount": {
144            "description": "The number of employees in the business.",
145            "minimum": 1,
146            "title": "Business Employee Count",
147            "type": "integer"
148          },
149          "entityType": {
150            "description": "Business type can be empty or one of Sole Proprietorship, Partnership, Co-operative, Limited Liability Corporation, Non-profit Corporation, Corporation",
151            "enum": [
152              "Sole Proprietorship",
153              "Partnership",
154              "Limited Liability Corporation",
155              "Co-operative",
156              "Non-profit Corporation",
157              "Corporation"
158            ],
159            "title": "Business Type",
160            "type": "string"
161          },
162          "identityType": {
163            "description": "Whether the company is an ISV (independent software vendor) or direct customer.",
164            "enum": [
165              "direct_customer",
166              "isv_reseller_or_partner"
167            ],
168            "title": "Business Identity (ISV vs. Direct)",
169            "type": "string"
170          },
171          "industry": {
172            "description": "Business industry should be one of AGRICULTURE, COMMUNICATION, CONSTRUCTION, EDUCATION, ENERGY, ENTERTAINMENT, FINANCIAL, GAMBLING, GOVERNMENT, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, LEGAL, MANUFACTURING, NGO, POLITICAL, POSTAL, PROFESSIONAL, REAL_ESTATE, RETAIL, TECHNOLOGY, TRANSPORTATION",
173            "enum": [
174              "AUTOMOTIVE",
175              "AGRICULTURE",
176              "BANKING",
177              "CONSTRUCTION",
178              "CONSUMER",
179              "EDUCATION",
180              "ENGINEERING",
181              "ENERGY",
182              "OIL_AND_GAS",
183              "FAST_MOVING_CONSUMER_GOODS",
184              "FINANCIAL",
185              "FINTECH",
186              "FOOD_AND_BEVERAGE",
187              "GOVERNMENT",
188              "HEALTHCARE",
189              "HOSPITALITY",
190              "INSURANCE",
191              "LEGAL",
192              "MANUFACTURING",
193              "MEDIA",
194              "ONLINE",
195              "PROFESSIONAL_SERVICES",
196              "RAW_MATERIALS",
197              "REAL_ESTATE",
198              "RELIGION",
199              "RETAIL",
200              "JEWELRY",
201              "TECHNOLOGY",
202              "TELECOMMUNICATIONS",
203              "TRANSPORTATION",
204              "TRAVEL",
205              "ELECTRONICS",
206              "NOT_FOR_PROFIT"
207            ],
208            "title": "Business Industry",
209            "type": "string"
210          },
211          "isSubassigned": {
212            "description": "Choose any one of the following values : [YES, NO]. A sub assigned phone number is where Independent Software Vendor (ISV) assigns the Twilio phone number to their end customer. If you are a direct customer, answer NO.",
213            "enum": [
214              "YES",
215              "NO"
216            ],
217            "title": "Will you subassign this number to your end customers?",
218            "type": "string"
219          },
220          "legalName": {
221            "description": "Name of the business entity",
222            "maxLength": 255,
223            "minLength": 1,
224            "title": "Business Name",
225            "type": "string"
226          },
227          "privacyNoticeUrl": {
228            "description": "The privacy notice/policy website that explains how the business collects, uses, and protects personal data.",
229            "format": "uri",
230            "pattern": "^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?:[Ww]{3}\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&/=]*)$",
231            "title": "Privacy Notice URL",
232            "type": [
233              "string",
234              "null"
235            ]
236          },
237          "registrationAuthority": {
238            "description": "The registrar the business is registered with: EIN(US), DUNS, CBN(CA), CCN(CA), CRN(UK), OTHER",
239            "enum": [
240              "EIN",
241              "DUNS",
242              "CBN",
243              "CCN",
244              "CRN",
245              "OTHER"
246            ],
247            "title": "Business Registration Identifier",
248            "type": "string"
249          },
250          "registrationNumber": {
251            "description": "The ID number of the business in the business registrar",
252            "maxLength": 21,
253            "minLength": 1,
254            "title": "Business Registration Number",
255            "type": "string"
256          },
257          "tradeName": {
258            "description": "The trade name or DBA name that the business uses to operate under that is different than the legal name.",
259            "maxLength": 255,
260            "minLength": 1,
261            "title": "Business Trade Name",
262            "type": [
263              "string",
264              "null"
265            ]
266          },
267          "websiteUrl": {
268            "description": "The URL of the business website",
269            "format": "uri",
270            "minLength": 1,
271            "pattern": "^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?:[Ww]{3}\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&/=]*)$",
272            "title": "Website URL",
273            "type": "string"
274          }
275        },
276        "required": [
277          "legalName",
278          "entityType",
279          "identityType",
280          "registrationNumber",
281          "registrationAuthority",
282          "industry",
283          "websiteUrl",
284          "isSubassigned",
285          "employeeCount"
286        ],
287        "type": "object"
288      },
289      "useCase": {
290        "additionalProperties": false,
291        "description": "What the branded calling products will be used for.",
292        "properties": {
293          "callVolumeDaily": {
294            "description": "The number of calls expected to be placed per day.",
295            "minimum": 1,
296            "title": "Call Volume Daily",
297            "type": "integer"
298          },
299          "category": {
300            "description": "The branded calling use case category.",
301            "enum": [
302              "2FA",
303              "ACCOUNT_NOTIFICATION",
304              "AGENTS_FRANCHISES",
305              "CARRIER_EXEMPT",
306              "CHARITY",
307              "CUSTOMER_CARE",
308              "DELIVERY_NOTIFICATION",
309              "EMERGENCY",
310              "FRAUD_ALERT",
311              "HIGHER_EDUCATION",
312              "K12_EDUCATION",
313              "LOW_VOLUME",
314              "MARKETING",
315              "MIXED",
316              "POLITICAL",
317              "POLLING_VOTING",
318              "PROXY",
319              "PUBLIC_SERVICE_ANNOUNCEMENT",
320              "SECURITY_ALERT",
321              "SOCIAL",
322              "SOLE_PROPRIETOR",
323              "SWEEPSTAKE"
324            ],
325            "title": "Use Case Category",
326            "type": "string"
327          },
328          "consentDescription": {
329            "description": "The branded calling consent use case description.",
330            "minLength": 1,
331            "title": "Use Case Consent Description",
332            "type": "string"
333          },
334          "description": {
335            "description": "The branded calling use case description.",
336            "minLength": 1,
337            "title": "Use Case Description",
338            "type": "string"
339          }
340        },
341        "required": [
342          "category",
343          "description",
344          "consentDescription",
345          "callVolumeDaily"
346        ],
347        "type": "object"
348      }
349    },
350    "required": [
351      "brandedCaller",
352      "authorizedRepresentative1",
353      "business",
354      "useCase",
355      "address"
356    ],
357    "title": "Branded Calling - UK",
358    "type": "object",
359    "x-acceptableDocuments": [
360      {
361        "description": "The letter to authorize Twilio to run voice traffic on a given set of Phone Numbers.",
362        "documents": [
363          {
364            "description": "Letter of Authorization containing Brand Name, Tax ID, Tax country, Legal Name, Address, Phone #",
365            "documentType": "letter_of_authorization",
366            "friendlyName": "Letter of Authorization"
367          }
368        ],
369        "friendlyName": "Letter of Authorization"
370      }
371    ]
372  },
373  "subType": "BRANDED_CALLS",
374  "type": "VOICE_TRUST",
375  "version": 4
376}

Create a Compliance Registration

POST https://trusthub.twilio.com/v4/Compliance/Registrations

To create a Branded Calling Compliance Registration, make a POST request to the Compliance Registrations resource. The response includes the Compliance Registration ID (data.address.id). Save the ID for later.

US Basic Branded CallingUS Enhanced Branded CallingNon-US Branded Calling

US Basic Branded Calling: Create a Compliance Registration

1curl -X POST 'https://trusthub.twilio.com/v4/Compliance/Registrations' \
2--header 'Content-Type: application/json' \
3--data-raw '{
4  "data": {
5    "brandedCaller": {
6        "voiceIntegrityRegistrationId": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
7        "displayName": "Brand Name",
8        "displayLongName": "Brand long name"
9    }
10  },
11  "regulationId": "RNca63d1066fbd5e44eac02d0b3cf6d019",
12  "regulationVersion": 13,
13  "comments": "Sample comment",
14  "friendlyName": "Registration friendlyName",
15  "statusNotificationEmail": "notifcation@email.com",
16  "statusCallbackUrl": "https://statuscallback.example.com"
17}'
18-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "comments": null,
3  "data": {
4    "brandedCaller": {
5      "displayLongName": "Brand long name",
6      "displayName": "Brand Name",
7      "voiceIntegrityRegistrationId": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab"
8    }
9  },
10  "dataErrors": null,
11  "dateCreated": "2025-10-21T19:01:30Z",
12  "dateExpires": null,
13  "dateUpdated": "2025-10-21T19:01:30Z",
14  "documentLinks": [],
15  "friendlyName": "Registration friendlyName",
16  "id": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
17  "regulationId": "RNca63d1066fbd5e44eac02d0b3cf6d019",
18  "regulationVersion": 13,
19  "status": "DRAFT",
20  "statusCallbackUrl": "https://statuscallback.example.com",
21  "statusNotificationEmail": "notifcation@email.com"
22}

US Enhanced Branded Calling: Create a Compliance Registration

1curl -X POST 'https://trusthub.twilio.com/v4/Compliance/Registrations' \
2--header 'Content-Type: application/json' \
3--data-raw '{
4  "data": {
5    "address": {
6        "id": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
7    },
8    "authorizedRepresentative1": {
9      "firstName": "Bob",
10      "lastName": "Smith",
11      "email": "bsmith@email.com",
12      "phoneE164": "+19832979578",
13      "jobPosition": "CEO"
14    },
15    "useCase": {
16        "category": "HIGHER_EDUCATION",
17        "description": "UseCase description",
18        "consentDescription": "Consent description",
19        "callVolumeDaily": 100,
20        "categoryApple": "Optional category"
21
22    },
23    "authorizedContact": {
24        "firstName": "John",
25        "lastName": "Doe",
26        "mobilePhoneE164": "+19318339216",
27        "verificationEmail": "johndoe@email.com"
28    },
29    "brandedCaller": {
30        "displayName": "Brand Display Name",
31        "displayCallReason": "Call Reason",
32        "displayLogoUrl": "https://www.logo.example.com"
33    },
34    "business": {
35        "legalName": "Business Name",
36        "entityType": "Partnership",
37        "identityType": "direct_customer",
38        "isSubassigned": "NO",
39        "registrationNumber": "123456789",
40        "registrationAuthority": "EIN",
41        "industry": "RAW_MATERIALS",
42        "websiteUrl": "https://www.wesbite.example.com",
43        "employeeCount": 1000
44    }
45  },
46  "regulationId": "RNa0b74679be7511921f4d2e3094fa6d23",
47  "regulationVersion": 9,
48  "comments": "Sample comment",
49  "friendlyName": "Registration friendlyName",
50  "statusNotificationEmail": "notifcation@email.com",
51  "statusCallbackUrl": "https://statuscallback.example.com"
52}'
53-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "comments": null,
3  "data": {
4    "address": {
5      "id": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
6    },
7    "authorizedContact": {
8      "firstName": "John",
9      "lastName": "Doe",
10      "mobilePhoneE164": "+19318339216",
11      "verificationEmail": "johndoe@email.com"
12    },
13    "authorizedRepresentative1": {
14      "email": "bsmith@email.com",
15      "firstName": "Bob",
16      "jobPosition": "CEO",
17      "lastName": "Smith",
18      "phoneE164": "+19832979578"
19    },
20    "brandedCaller": {
21      "displayCallReason": "Call Reason",
22      "displayLogoUrl": "https://www.logo.example.com",
23      "displayName": "Brand Display Name"
24    },
25    "business": {
26      "employeeCount": 1000,
27      "entityType": "Partnership",
28      "identityType": "direct_customer",
29      "industry": "RAW_MATERIALS",
30      "isSubassigned": "NO",
31      "legalName": "Business Name",
32      "registrationAuthority": "EIN",
33      "registrationNumber": "123456789",
34      "websiteUrl": "https://www.website.example.com"
35    },
36    "useCase": {
37      "callVolumeDaily": 100,
38      "category": "HIGHER_EDUCATION",
39      "categoryApple": "Optional category",
40      "consentDescription": "Consent description",
41      "description": "UseCase description"
42    }
43  },
44  "dataErrors": null,
45  "dateCreated": "2025-10-16T10:21:20Z",
46  "dateExpires": null,
47  "dateUpdated": "2025-10-16T10:21:21Z",
48  "documentLinks": [],
49  "friendlyName": "Registration friendlyName",
50  "id": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
51  "regulationId": "RNa0b74679be7511921f4d2e3094fa6d23",
52  "regulationVersion": 9,
53  "status": "DRAFT",
54  "statusCallbackUrl": "https://statuscallback.example.com",
55  "statusNotificationEmail": "notifcation@email.com"
56}

The following example is for the United Kingdom (country: GB).

Non-US Branded Calling (UK): Create a Compliance Registration

1curl -X POST 'https://trusthub.twilio.com/v4/Compliance/Registrations' \
2--header 'Content-Type: application/json' \
3--data-raw '{
4  "data": {
5    "address": {
6        "id": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
7    },
8    "authorizedRepresentative1": {
9      "firstName": "Bob",
10      "lastName": "Smith",
11      "email": "bsmith@email.com",
12      "phoneE164": "+19832979578",
13      "jobPosition": "CEO"
14    },
15    "useCase": {
16        "category": "HIGHER_EDUCATION",
17        "description": "UseCase description",
18        "consentDescription": "Consent description",
19        "callVolumeDaily": 100
20
21    },
22    "authorizedContact": {
23        "firstName": "John",
24        "lastName": "Doe",
25        "mobilePhoneE164": "+19318339216",
26        "verificationEmail": "johndoe@email.com"
27    },
28    "brandedCaller": {
29        "displayName": "Brand Display Name"
30    },
31    "business": {
32        "legalName": "Business Name",
33        "entityType": "Partnership",
34        "identityType": "direct_customer",
35        "isSubassigned": "NO",
36        "registrationNumber": "123456789",
37        "registrationAuthority": "CRN",
38        "industry": "RAW_MATERIALS",
39        "websiteUrl": "https://www.website.example.com",
40        "employeeCount": 1000
41    }
42  },
43  "regulationId": "RN304faa2408f673b68867fe5cb65b7f50",
44  "regulationVersion": 4,
45  "comments": "Sample comment",
46  "friendlyName": "Registration friendlyName",
47  "statusNotificationEmail": "notifcation@email.com",
48  "statusCallbackUrl": "https://statuscallback.example.com"
49}'
50-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "comments": null,
3  "data": {
4    "address": {
5      "id": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
6    },
7    "authorizedContact": {
8      "firstName": "John",
9      "lastName": "Doe",
10      "mobilePhoneE164": "+19318339216",
11      "verificationEmail": "johndoe@email.com"
12    },
13    "authorizedRepresentative1": {
14      "email": "bsmith@email.com",
15      "firstName": "Bob",
16      "jobPosition": "CEO",
17      "lastName": "Smith",
18      "phoneE164": "+19832979578"
19    },
20    "brandedCaller": {
21      "displayName": "Brand Display Name"
22    },
23    "business": {
24      "employeeCount": 1000,
25      "entityType": "Partnership",
26      "identityType": "direct_customer",
27      "industry": "RAW_MATERIALS",
28      "isSubassigned": "NO",
29      "legalName": "Business Name",
30      "registrationAuthority": "CRN",
31      "registrationNumber": "123456789",
32      "websiteUrl": "https://www.website.example.com"
33    },
34    "useCase": {
35      "callVolumeDaily": 100,
36      "category": "HIGHER_EDUCATION",
37      "consentDescription": "Consent description",
38      "description": "UseCase description"
39    }
40  },
41  "dataErrors": null,
42  "dateCreated": "2025-10-16T10:21:20Z",
43  "dateExpires": null,
44  "dateUpdated": "2025-10-16T10:21:21Z",
45  "documentLinks": [],
46  "friendlyName": "Registration friendlyName",
47  "id": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
48  "regulationId": "RN304faa2408f673b68867fe5cb65b7f50",
49  "regulationVersion": 4,
50  "status": "DRAFT",
51  "statusCallbackUrl": "https://statuscallback.example.com",
52  "statusNotificationEmail": "notifcation@email.com"
53}

Upload a signed LOA

POST https://trusthub.twilio.com/v4/Compliance/Documents

To upload a signed LOA for compliance verification, make a POST request to the Compliance Documents resource. The response includes the Document ID (documentId). Save the ID for later.

Note: This request uses form parameters (--form). The --form option sends data as multipart/form-data, and each --form line represents a separate form parameter in the request body.

Create a Compliance Document: Upload a signed LOA

1curl -X POST 'https://trusthub.twilio.com/v4/Compliance/Documents' \
2--form 'type="LETTER_OF_AUTHORIZATION"' \
3--form 'content=@"/Users/John/Documents/loa.jpg"' \
4--form 'friendlyName="letter of auth doc"'
5-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "contentType": "image/jpeg",
3  "contentUrl": "https://trusthub.twilio.com/v4/Compliance/Documents/RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Content",
4  "dateCreated": "2025-10-16T10:28:15Z",
5  "dateUpdated": "2025-10-16T10:28:15Z",
6  "friendlyName": "letter of auth doc",
7  "id": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
8  "type": "LETTER_OF_AUTHORIZATION"
9}

Link the LOA with your Compliance Registration

POST https://trusthub.twilio.com/v4/Compliance/DocumentLinks

To link the LOA with your Compliance Registration, make a POST request to the Compliance DocumentLinks resource. Use the Compliance Registration ID and the Document ID returned from the previous steps.

Create a DocumentLink: Link the LOA with your Compliance Registration

1curl -X POST 'https://trusthub.twilio.com/v4/Compliance/DocumentLinks' \
2--header 'Content-Type: application/json' \
3--data '{
4  "documentId": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "registrationId": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
6}'
7-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "dateCreated": "2025-10-16T10:30:35Z",
3  "documentId": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "id": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "registrationId": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6  "status": "DRAFT"
7}

Assign a phone number to your Compliance Registration

POST https://trusthub.twilio.com/v1/Compliance/Registrations/{registration_id}/ResourceAssignments

(information)

API version and case formatting

This request uses the API version v1. Query parameters and response fields are snake_case, and request body parameters are PascalCase.

To assign a phone number to your Compliance Registration, make a POST request to the ResourceAssignments subresource. Use the Compliance Registration ID returned from the previous step.

You can make this request only if the Compliance Registration's status is DRAFT, TWILIO_APPROVED, or TWILIO_REJECTED.

Note: This request uses form parameters (--form). The --form option sends data as multipart/form-data, and each --form line represents a separate form parameter in the request body.

Create a ResourceAssignment: Assign a phone number to your Compliance Registration

1curl -X POST 'https://trusthub.twilio.com/v1/Compliance/Registrations/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ResourceAssignments' \
2--form 'Type="phone-number"' \
3--form 'ResourceSid="PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"'
4-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "date_created": "2025-10-16T10:37:49Z",
4  "registration_id": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "resource_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6  "sid": "RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
7  "type": "phone-number",
8  "url": "https://trusthub.twilio.com/v1/Compliance/Registrations/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ResourceAssignments/RAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
9}

Submit the Compliance Registration

PATCH https://trusthub.twilio.com/v4/Compliance/Registrations/{id}

To submit the Compliance Registration for review, make a PATCH request to the Compliance Registration resource with its ID. Set the status parameter in the request body to PENDING_REVIEW.

Submit the Compliance Registration

1curl -X PATCH 'https://trusthub.twilio.com/v4/Compliance/Registrations/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' \
2--header 'Content-Type: application/json' \
3--data '{
4    "status": "PENDING_REVIEW"
5}'
6-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "comments": null,
3  "data": {
4    "address": {
5      "id": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
6    },
7    "authorizedContact": {
8      "firstName": "John",
9      "lastName": "Doe",
10      "mobilePhoneE164": "+19318339216",
11      "verificationEmail": "johndoe@email.com"
12    },
13    "authorizedRepresentative1": {
14      "email": "bsmith@email.com",
15      "firstName": "Bob",
16      "jobPosition": "CEO",
17      "lastName": "Smith",
18      "phoneE164": "+19832979578"
19    },
20    "brandedCaller": {
21      "displayCallReason": "Call Reason",
22      "displayLogoUrl": "https://www.logo.example.com",
23      "displayName": "Brand Display Name"
24    },
25    "business": {
26      "employeeCount": 1000,
27      "entityType": "Partnership",
28      "identityType": "direct_customer",
29      "industry": "RAW_MATERIALS",
30      "isSubassigned": "NO",
31      "legalName": "Business Name",
32      "registrationAuthority": "EIN",
33      "registrationNumber": "123456789",
34      "websiteUrl": "https://www.website.example.com"
35    },
36    "useCase": {
37      "callVolumeDaily": 100,
38      "category": "HIGHER_EDUCATION",
39      "categoryApple": "Optional category",
40      "consentDescription": "Consent description",
41      "description": "UseCase description"
42    }
43  },
44  "dataErrors": null,
45  "dateCreated": "2025-10-16T10:21:20Z",
46  "dateExpires": null,
47  "dateUpdated": "2025-10-16T10:44:28Z",
48  "documentLinks": [
49    {
50      "dateCreated": "2025-10-16T10:30:35Z",
51      "documentId": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
52      "id": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
53      "registrationId": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
54      "status": "DRAFT"
55    }
56  ],
57  "friendlyName": "Registration friendlyName",
58  "id": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
59  "regulationId": "RNa0b74679be7511921f4d2e3094fa6d23",
60  "regulationVersion": 9,
61  "status": "PENDING_REVIEW",
62  "statusCallbackUrl": "https://statuscallback.example.com",
63  "statusNotificationEmail": "notifcation@email.com"
64}

(Optional) Retrieve the submission status

GET https://trusthub.twilio.com/v4/Compliance/Registrations/{registration_id}

To retrieve the submission status, make a GET request to the Compliance Registration resource with its ID. Possible status values are DRAFT, PENDING_REVIEW, IN_REVIEW, TWILIO_APPROVED, and TWILIO_REJECTED.

Retrieve the submission status

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Registrations/BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "comments": null,
3  "data": {
4    "address": {
5      "id": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
6    },
7    "authorizedContact": {
8      "firstName": "John",
9      "lastName": "Doe",
10      "mobilePhoneE164": "+19318339216",
11      "verificationEmail": "johndoe@email.com"
12    },
13    "authorizedRepresentative1": {
14      "email": "bsmith@email.com",
15      "firstName": "Bob",
16      "jobPosition": "CEO",
17      "lastName": "Smith",
18      "phoneE164": "+19832979578"
19    },
20    "brandedCaller": {
21      "displayCallReason": "Call Reason",
22      "displayLogoUrl": "https://www.logo.example.com",
23      "displayName": "Brand Display Name"
24    },
25    "business": {
26      "employeeCount": 1000,
27      "entityType": "Partnership",
28      "identityType": "direct_customer",
29      "industry": "RAW_MATERIALS",
30      "isSubassigned": "NO",
31      "legalName": "Business Name",
32      "registrationAuthority": "EIN",
33      "registrationNumber": "123456789",
34      "websiteUrl": "https://www.website.example.com"
35    },
36    "useCase": {
37      "callVolumeDaily": 100,
38      "category": "HIGHER_EDUCATION",
39      "categoryApple": "Optional category",
40      "consentDescription": "Consent description",
41      "description": "UseCase description"
42    }
43  },
44  "dataErrors": null,
45  "dateCreated": "2025-10-17T09:59:16Z",
46  "dateExpires": null,
47  "dateUpdated": "2025-10-17T09:59:16Z",
48  "documentLinks": [
49    {
50      "dateCreated": "2025-11-12T09:05:31Z",
51      "documentId": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
52      "id": "BVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
53      "registrationId": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
54      "status": "DRAFT"
55    }
56  ],
57  "friendlyName": "Registration friendlyName",
58  "id": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
59  "regulationId": "RNa0b74679be7511921f4d2e3094fa6d23",
60  "regulationVersion": 9,
61  "status": "DRAFT",
62  "statusCallbackUrl": "https://statuscallback.example.com",
63  "statusNotificationEmail": "notifcation@email.com"
64}

Result

After following this guide, you can use the Twilio TrustHub API to completely automate the submission of customer registration profiles, attach supporting Letters of Authorization (LOAs), and verify assignment statuses. You can confirm success by polling the registration state via the API and seeing the status transition out of DRAFT.

Next steps

Explore the following guides to build on what you've learned in this guide:

US Basic Branded Calling: Learn how to assign numbers and manage brand configurations via the console or Trust Products API inside the US.
US Enhanced Branded Calling: Learn how to attach logos and clear call context to call intents via verified branding profiles.
Non-US Basic Branded Calling: Learn how to establish basic business display metadata for phone numbers in Canada, Germany, and the UK.