Create a new Compliance Registration Inquiry for the authenticated account. This is necessary to start a new embedded session.

POST /v1/ComplianceInquiries/Registration/RegulatoryCompliance/GB/Initialize
Account sid auth token

Create a new Compliance Registration Inquiry for the authenticated account. This is necessary to start a new embedded session.

application/x-www-form-urlencoded

Body

  • EndUserType string Required

    Values are Individual or Business.

  • PhoneNumberType string Required

    Values are local, national, mobile, or toll-free.

  • BusinessIdentityType string

    Values are direct_customer, isv_reseller_or_partner, or unknown.

  • BusinessRegistrationAuthority string

    Values are UK:CRN, US:EIN, CA:CBN, AU:ACN, or Other.

  • BusinessLegalName string

    he name of the business or organization using the Tollfree number.

  • NotificationEmail string

    he email address to receive the notification about the verification result.

  • AcceptedNotificationReceipt boolean

    The email address to receive the notification about the verification result.

  • BusinessRegistrationNumber string

    Business registration number of the business

  • BusinessWebsiteUrl string

    The URL of the business website

  • FriendlyName string

    Friendly name for your business information

  • AuthorizedRepresentative1FirstName string

    First name of the authorized representative

  • AuthorizedRepresentative1LastName string

    Last name of the authorized representative

  • AuthorizedRepresentative1Phone string

    Phone number of the authorized representative

  • AuthorizedRepresentative1Email string

    Email address of the authorized representative

  • AuthorizedRepresentative1DateOfBirth string

    Birthdate of the authorized representative

  • AddressStreet string

    Street address of the business

  • AddressStreetSecondary string

    Street address of the business

  • AddressCity string

    City of the business

  • AddressSubdivision string

    State or province of the business

  • AddressPostalCode string

    Postal code of the business

  • AddressCountryCode string

    Country code of the business

  • EmergencyAddressStreet string

    Street address of the business

  • EmergencyAddressStreetSecondary string

    Street address of the business

  • EmergencyAddressCity string

    City of the business

  • EmergencyAddressSubdivision string

    State or province of the business

  • EmergencyAddressPostalCode string

    Postal code of the business

  • EmergencyAddressCountryCode string

    Country code of the business

  • UseAddressAsEmergencyAddress boolean

    Use the business address as the emergency address

  • FileName string

    The name of the verification document to upload

  • File string

    The verification document to upload

  • FirstName string

    The first name of the Individual User.

  • LastName string

    The last name of the Individual User.

  • DateOfBirth string

    The date of birth of the Individual User.

  • IndividualEmail string

    The email address of the Individual User.

  • IndividualPhone string

    The phone number of the Individual User.

  • IsIsvEmbed boolean

    Indicates if the inquiry is being started from an ISV embedded component.

  • IsvRegisteringForSelfOrTenant string

    Indicates if the isv registering for self or tenant.

  • StatusCallbackUrl string

    The url we call to inform you of bundle changes.

  • ThemeSetId string

    Theme id for styling the inquiry form.

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • inquiry_id string | null

      The unique ID used to start an embedded compliance registration session.

    • inquiry_session_token string | null

      The session token used to start an embedded compliance registration session.

    • registration_id string | null

      The RegistrationId matching the Registration Profile that should be resumed or resubmitted for editing.

    • url string(uri) | null

      The URL of this resource.
POST /v1/ComplianceInquiries/Registration/RegulatoryCompliance/GB/Initialize 
curl \
 --request POST 'https://trusthub.twilio.com/v1/ComplianceInquiries/Registration/RegulatoryCompliance/GB/Initialize' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'EndUserType=Individual&FirstName=firstname&LastName=lastname&DateOfBirth=1990-01-01&IndividualEmail=test%40test.com&IndividualPhone=123456&PhoneNumberType=national&BusinessLegalName=Owl%2C+Inc.&NotificationEmail=test%40test.com&AcceptedNotificationReceipt=true&BusinessRegistrationNumber=123456789&BusinessWebsiteUrl=https%3A%2F%2Ftwilio.co&FriendlyName=Owl&AuthorizedRepresentative1FirstName=firstname&AuthorizedRepresentative1LastName=lastname&AuthorizedRepresentative1Email=test%40test.com&AuthorizedRepresentative1DateOfBirth=1990-01-01&AuthorizedRepresentative1Phone=%2B9199992222222&AddressStreet=123+Main+St&AddressStreetSecondary=Apt+1&AddressCity=San+Francisco&AddressSubdivision=CA&AddressPostalCode=94107&AddressCountryCode=US&UseAddressAsEmergencyAddress=true&EmergencyAddressStreet=123+Main+St&EmergencyAddressStreetSecondary=Apt+1&EmergencyAddressCity=San+Francisco&EmergencyAddressSubdivision=CA&EmergencyAddressPostalCode=94107&EmergencyAddressCountryCode=US&FileName=fileName&File=file&BusinessIdentityType=direct_customer&BusinessRegistrationAuthority=UK%3ACRN&IsIsvEmbed=true&IsvRegisteringForSelfOrTenant=my_customer&StatusCallbackUrl=https%3A%2F%2Fstatus.com&ThemeSetId=th_xxxxx'
Request example 
{"EndUserType" => "Individual", "FirstName" => "firstname", "LastName" => "lastname", "DateOfBirth" => "1990-01-01", "IndividualEmail" => "test@test.com", "IndividualPhone" => "123456", "PhoneNumberType" => "national", "BusinessLegalName" => "Owl, Inc.", "NotificationEmail" => "test@test.com", "AcceptedNotificationReceipt" => true, "BusinessRegistrationNumber" => "123456789", "BusinessWebsiteUrl" => "https://twilio.co", "FriendlyName" => "Owl", "AuthorizedRepresentative1FirstName" => "firstname", "AuthorizedRepresentative1LastName" => "lastname", "AuthorizedRepresentative1Email" => "test@test.com", "AuthorizedRepresentative1DateOfBirth" => "1990-01-01", "AuthorizedRepresentative1Phone" => "+9199992222222", "AddressStreet" => "123 Main St", "AddressStreetSecondary" => "Apt 1", "AddressCity" => "San Francisco", "AddressSubdivision" => "CA", "AddressPostalCode" => "94107", "AddressCountryCode" => "US", "UseAddressAsEmergencyAddress" => true, "EmergencyAddressStreet" => "123 Main St", "EmergencyAddressStreetSecondary" => "Apt 1", "EmergencyAddressCity" => "San Francisco", "EmergencyAddressSubdivision" => "CA", "EmergencyAddressPostalCode" => "94107", "EmergencyAddressCountryCode" => "US", "FileName" => "fileName", "File" => "file", "BusinessIdentityType" => "direct_customer", "BusinessRegistrationAuthority" => "UK:CRN", "IsIsvEmbed" => true, "IsvRegisteringForSelfOrTenant" => "my_customer", "StatusCallbackUrl" => "https://status.com", "ThemeSetId" => "th_xxxxx"}
Response examples (201) 
{
  "inquiry_id": "inq_aaaaaaaaaaaaaaaaaaaaaaaa",
  "inquiry_session_token": "new.session.token",
  "registration_id": "tri1.us1.account.ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.registartion.PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://trusthub.twilio.com/v1/ComplianceInquiries/Registration/tri1.us1.account.ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.registartion.PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/RegulatoryCompliance/GB/Initialize"
}