Loading...
Loading...
Manage regulatory requirements, number bundles, supporting documents, and verified numbers for compliance. This skill provides Java SDK examples.
npx skill4agent add team-telnyx/skills telnyx-numbers-compliance-java<!-- Maven -->
<dependency>
<groupId>com.telnyx.sdk</groupId>
<artifactId>telnyx</artifactId>
<version>6.36.0</version>
</dependency>
// Gradle
implementation("com.telnyx.sdk:telnyx:6.36.0")import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
TelnyxClient client = TelnyxOkHttpClient.fromEnv();clientimport com.telnyx.sdk.errors.TelnyxServiceException;
try {
var result = client.messages().send(params);
} catch (TelnyxServiceException e) {
System.err.println("API error " + e.statusCode() + ": " + e.getMessage());
if (e.statusCode() == 422) {
System.err.println("Validation error — check required fields and formats");
} else if (e.statusCode() == 429) {
// Rate limited — wait and retry with exponential backoff
Thread.sleep(1000);
}
}401403404422429+13125550001+.autoPager()for (var item : page.autoPager()) { ... }.hasNextPage().nextPage()GET /bundle_pricing/billing_bundlesimport com.telnyx.sdk.models.bundlepricing.billingbundles.BillingBundleListPage;
import com.telnyx.sdk.models.bundlepricing.billingbundles.BillingBundleListParams;
BillingBundleListPage page = client.bundlePricing().billingBundles().list();cost_codecreated_atcurrencyidis_publicmrc_pricenameslugspecsGET /bundle_pricing/billing_bundles/{bundle_id}import com.telnyx.sdk.models.bundlepricing.billingbundles.BillingBundleRetrieveParams;
import com.telnyx.sdk.models.bundlepricing.billingbundles.BillingBundleRetrieveResponse;
BillingBundleRetrieveResponse billingBundle = client.bundlePricing().billingBundles().retrieve("8661948c-a386-4385-837f-af00f40f111a");activebundle_limitscost_codecreated_atidis_publicnameslugGET /bundle_pricing/user_bundlesimport com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleListPage;
import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleListParams;
UserBundleListPage page = client.bundlePricing().userBundles().list();activebilling_bundlecreated_atidresourcesupdated_atuser_idPOST /bundle_pricing/user_bundles/bulkidempotency_keyitemsimport com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleCreateParams;
import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleCreateResponse;
UserBundleCreateResponse userBundle = client.bundlePricing().userBundles().create();activebilling_bundlecreated_atidresourcesupdated_atuser_idGET /bundle_pricing/user_bundles/unusedimport com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleListUnusedParams;
import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleListUnusedResponse;
UserBundleListUnusedResponse response = client.bundlePricing().userBundles().listUnused();billing_bundleuser_bundle_idsGET /bundle_pricing/user_bundles/{user_bundle_id}import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleRetrieveParams;
import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleRetrieveResponse;
UserBundleRetrieveResponse userBundle = client.bundlePricing().userBundles().retrieve("ca1d2263-d1f1-43ac-ba53-248e7a4bb26a");activebilling_bundlecreated_atidresourcesupdated_atuser_idDELETE /bundle_pricing/user_bundles/{user_bundle_id}import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleDeactivateParams;
import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleDeactivateResponse;
UserBundleDeactivateResponse response = client.bundlePricing().userBundles().deactivate("ca1d2263-d1f1-43ac-ba53-248e7a4bb26a");activebilling_bundlecreated_atidresourcesupdated_atuser_idGET /bundle_pricing/user_bundles/{user_bundle_id}/resourcesimport com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleListResourcesParams;
import com.telnyx.sdk.models.bundlepricing.userbundles.UserBundleListResourcesResponse;
UserBundleListResourcesResponse response = client.bundlePricing().userBundles().listResources("ca1d2263-d1f1-43ac-ba53-248e7a4bb26a");created_atidresourceresource_typeupdated_atGET /document_linksimport com.telnyx.sdk.models.documentlinks.DocumentLinkListPage;
import com.telnyx.sdk.models.documentlinks.DocumentLinkListParams;
DocumentLinkListPage page = client.documentLinks().list();created_atdocument_ididlinked_record_typelinked_resource_idrecord_typeupdated_atGET /documentsimport com.telnyx.sdk.models.documents.DocumentListPage;
import com.telnyx.sdk.models.documents.DocumentListParams;
DocumentListPage page = client.documents().list();av_scan_statuscontent_typecreated_atcustomer_referencefilenameidrecord_typesha256sizestatusupdated_atPOST /documentscustomer_referencefilefilenameurlimport com.telnyx.sdk.models.documents.DocumentUploadJsonParams;
import com.telnyx.sdk.models.documents.DocumentUploadJsonResponse;
DocumentUploadJsonResponse response = client.documents().uploadJson();av_scan_statuscontent_typecreated_atcustomer_referencefilenameidrecord_typesha256sizestatusupdated_atGET /documents/{id}import com.telnyx.sdk.models.documents.DocumentRetrieveParams;
import com.telnyx.sdk.models.documents.DocumentRetrieveResponse;
DocumentRetrieveResponse document = client.documents().retrieve("6a09cdc3-8948-47f0-aa62-74ac943d6c58");av_scan_statuscontent_typecreated_atcustomer_referencefilenameidrecord_typesha256sizestatusupdated_atPATCH /documents/{id}av_scan_statuscontent_typecreated_atcustomer_referencefilenameidrecord_typesha256sizestatusupdated_atimport com.telnyx.sdk.models.documents.DocServiceDocument;
import com.telnyx.sdk.models.documents.DocumentUpdateParams;
import com.telnyx.sdk.models.documents.DocumentUpdateResponse;
DocumentUpdateParams params = DocumentUpdateParams.builder()
.documentId("6a09cdc3-8948-47f0-aa62-74ac943d6c58")
.docServiceDocument(DocServiceDocument.builder().build())
.build();
DocumentUpdateResponse document = client.documents().update(params);av_scan_statuscontent_typecreated_atcustomer_referencefilenameidrecord_typesha256sizestatusupdated_atDELETE /documents/{id}import com.telnyx.sdk.models.documents.DocumentDeleteParams;
import com.telnyx.sdk.models.documents.DocumentDeleteResponse;
DocumentDeleteResponse document = client.documents().delete("6a09cdc3-8948-47f0-aa62-74ac943d6c58");av_scan_statuscontent_typecreated_atcustomer_referencefilenameidrecord_typesha256sizestatusupdated_atGET /documents/{id}/downloadimport com.telnyx.sdk.core.http.HttpResponse;
import com.telnyx.sdk.models.documents.DocumentDownloadParams;
HttpResponse response = client.documents().download("6a09cdc3-8948-47f0-aa62-74ac943d6c58");GET /documents/{id}/download_linkimport com.telnyx.sdk.models.documents.DocumentGenerateDownloadLinkParams;
import com.telnyx.sdk.models.documents.DocumentGenerateDownloadLinkResponse;
DocumentGenerateDownloadLinkResponse response = client.documents().generateDownloadLink("550e8400-e29b-41d4-a716-446655440000");urlPOST /number_order_phone_numbers/{id}/requirement_grouprequirement_group_idimport com.telnyx.sdk.models.numberorderphonenumbers.NumberOrderPhoneNumberUpdateRequirementGroupParams;
import com.telnyx.sdk.models.numberorderphonenumbers.NumberOrderPhoneNumberUpdateRequirementGroupResponse;
NumberOrderPhoneNumberUpdateRequirementGroupParams params = NumberOrderPhoneNumberUpdateRequirementGroupParams.builder()
.id("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
.requirementGroupId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
.build();
NumberOrderPhoneNumberUpdateRequirementGroupResponse response = client.numberOrderPhoneNumbers().updateRequirementGroup(params);bundle_idcountry_codedeadlineidis_block_numberlocalityorder_request_idphone_numberphone_number_typerecord_typeregulatory_requirementsrequirements_metrequirements_statusstatussub_number_order_idGET /phone_numbers_regulatory_requirementsimport com.telnyx.sdk.models.phonenumbersregulatoryrequirements.PhoneNumbersRegulatoryRequirementRetrieveParams;
import com.telnyx.sdk.models.phonenumbersregulatoryrequirements.PhoneNumbersRegulatoryRequirementRetrieveResponse;
PhoneNumbersRegulatoryRequirementRetrieveResponse phoneNumbersRegulatoryRequirement = client.phoneNumbersRegulatoryRequirements().retrieve();phone_numberphone_number_typerecord_typeregion_informationregulatory_requirementsGET /regulatory_requirementsimport com.telnyx.sdk.models.regulatoryrequirements.RegulatoryRequirementRetrieveParams;
import com.telnyx.sdk.models.regulatoryrequirements.RegulatoryRequirementRetrieveResponse;
RegulatoryRequirementRetrieveResponse regulatoryRequirement = client.regulatoryRequirements().retrieve();actioncountry_codephone_number_typeregulatory_requirementsGET /requirement_groupsimport com.telnyx.sdk.models.requirementgroups.RequirementGroup;
import com.telnyx.sdk.models.requirementgroups.RequirementGroupListParams;
List<RequirementGroup> requirementGroups = client.requirementGroups().list();POST /requirement_groupscountry_codephone_number_typeactioncustomer_referenceregulatory_requirementsimport com.telnyx.sdk.models.requirementgroups.RequirementGroup;
import com.telnyx.sdk.models.requirementgroups.RequirementGroupCreateParams;
RequirementGroupCreateParams params = RequirementGroupCreateParams.builder()
.action(RequirementGroupCreateParams.Action.ORDERING)
.countryCode("US")
.phoneNumberType(RequirementGroupCreateParams.PhoneNumberType.LOCAL)
.build();
RequirementGroup requirementGroup = client.requirementGroups().create(params);actioncountry_codecreated_atcustomer_referenceidphone_number_typerecord_typeregulatory_requirementsstatusupdated_atGET /requirement_groups/{id}import com.telnyx.sdk.models.requirementgroups.RequirementGroup;
import com.telnyx.sdk.models.requirementgroups.RequirementGroupRetrieveParams;
RequirementGroup requirementGroup = client.requirementGroups().retrieve("550e8400-e29b-41d4-a716-446655440000");actioncountry_codecreated_atcustomer_referenceidphone_number_typerecord_typeregulatory_requirementsstatusupdated_atPATCH /requirement_groups/{id}customer_referenceregulatory_requirementsimport com.telnyx.sdk.models.requirementgroups.RequirementGroup;
import com.telnyx.sdk.models.requirementgroups.RequirementGroupUpdateParams;
RequirementGroup requirementGroup = client.requirementGroups().update("550e8400-e29b-41d4-a716-446655440000");actioncountry_codecreated_atcustomer_referenceidphone_number_typerecord_typeregulatory_requirementsstatusupdated_atDELETE /requirement_groups/{id}import com.telnyx.sdk.models.requirementgroups.RequirementGroup;
import com.telnyx.sdk.models.requirementgroups.RequirementGroupDeleteParams;
RequirementGroup requirementGroup = client.requirementGroups().delete("550e8400-e29b-41d4-a716-446655440000");actioncountry_codecreated_atcustomer_referenceidphone_number_typerecord_typeregulatory_requirementsstatusupdated_atPOST /requirement_groups/{id}/submit_for_approvalimport com.telnyx.sdk.models.requirementgroups.RequirementGroup;
import com.telnyx.sdk.models.requirementgroups.RequirementGroupSubmitForApprovalParams;
RequirementGroup requirementGroup = client.requirementGroups().submitForApproval("550e8400-e29b-41d4-a716-446655440000");actioncountry_codecreated_atcustomer_referenceidphone_number_typerecord_typeregulatory_requirementsstatusupdated_atGET /requirement_typesimport com.telnyx.sdk.models.requirementtypes.RequirementTypeListParams;
import com.telnyx.sdk.models.requirementtypes.RequirementTypeListResponse;
RequirementTypeListResponse requirementTypes = client.requirementTypes().list();acceptance_criteriacreated_atdescriptionexampleidnamerecord_typetypeupdated_atGET /requirement_types/{id}import com.telnyx.sdk.models.requirementtypes.RequirementTypeRetrieveParams;
import com.telnyx.sdk.models.requirementtypes.RequirementTypeRetrieveResponse;
RequirementTypeRetrieveResponse requirementType = client.requirementTypes().retrieve("a38c217a-8019-48f8-bff6-0fdd9939075b");acceptance_criteriacreated_atdescriptionexampleidnamerecord_typetypeupdated_atGET /requirementsimport com.telnyx.sdk.models.requirements.RequirementListPage;
import com.telnyx.sdk.models.requirements.RequirementListParams;
RequirementListPage page = client.requirements().list();actioncountry_codecreated_atidlocalityphone_number_typerecord_typerequirements_typesupdated_atGET /requirements/{id}import com.telnyx.sdk.models.requirements.RequirementRetrieveParams;
import com.telnyx.sdk.models.requirements.RequirementRetrieveResponse;
RequirementRetrieveResponse requirement = client.requirements().retrieve("a9dad8d5-fdbd-49d7-aa23-39bb08a5ebaa");actioncountry_codecreated_atidlocalityphone_number_typerecord_typerequirements_typesupdated_atPOST /sub_number_orders/{id}/requirement_grouprequirement_group_idimport com.telnyx.sdk.models.subnumberorders.SubNumberOrderUpdateRequirementGroupParams;
import com.telnyx.sdk.models.subnumberorders.SubNumberOrderUpdateRequirementGroupResponse;
SubNumberOrderUpdateRequirementGroupParams params = SubNumberOrderUpdateRequirementGroupParams.builder()
.id("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
.requirementGroupId("a4b201f9-8646-4e54-a7d2-b2e403eeaf8c")
.build();
SubNumberOrderUpdateRequirementGroupResponse response = client.subNumberOrders().updateRequirementGroup(params);country_codecreated_atcustomer_referenceidis_block_sub_number_orderorder_request_idphone_number_typephone_numbersphone_numbers_countrecord_typeregulatory_requirementsrequirements_metstatusupdated_atGET /user_addressesimport com.telnyx.sdk.models.useraddresses.UserAddressListPage;
import com.telnyx.sdk.models.useraddresses.UserAddressListParams;
UserAddressListPage page = client.userAddresses().list();administrative_areaboroughbusiness_namecountry_codecreated_atcustomer_referenceextended_addressfirst_nameidlast_namelocalityneighborhoodphone_numberpostal_coderecord_typestreet_addressupdated_atPOST /user_addressesfirst_namelast_namebusiness_namestreet_addresslocalitycountry_codeadministrative_areaboroughcustomer_referenceextended_addressneighborhoodphone_numberpostal_codeskip_address_verificationimport com.telnyx.sdk.models.useraddresses.UserAddressCreateParams;
import com.telnyx.sdk.models.useraddresses.UserAddressCreateResponse;
UserAddressCreateParams params = UserAddressCreateParams.builder()
.businessName("Toy-O'Kon")
.countryCode("US")
.firstName("Alfred")
.lastName("Foster")
.locality("Austin")
.streetAddress("600 Congress Avenue")
.build();
UserAddressCreateResponse userAddress = client.userAddresses().create(params);administrative_areaboroughbusiness_namecountry_codecreated_atcustomer_referenceextended_addressfirst_nameidlast_namelocalityneighborhoodphone_numberpostal_coderecord_typestreet_addressupdated_atGET /user_addresses/{id}import com.telnyx.sdk.models.useraddresses.UserAddressRetrieveParams;
import com.telnyx.sdk.models.useraddresses.UserAddressRetrieveResponse;
UserAddressRetrieveResponse userAddress = client.userAddresses().retrieve("550e8400-e29b-41d4-a716-446655440000");administrative_areaboroughbusiness_namecountry_codecreated_atcustomer_referenceextended_addressfirst_nameidlast_namelocalityneighborhoodphone_numberpostal_coderecord_typestreet_addressupdated_atGET /verified_numbersimport com.telnyx.sdk.models.verifiednumbers.VerifiedNumberListPage;
import com.telnyx.sdk.models.verifiednumbers.VerifiedNumberListParams;
VerifiedNumberListPage page = client.verifiedNumbers().list();phone_numberrecord_typeverified_atPOST /verified_numbersphone_numberverification_methodextensionimport com.telnyx.sdk.models.verifiednumbers.VerifiedNumberCreateParams;
import com.telnyx.sdk.models.verifiednumbers.VerifiedNumberCreateResponse;
VerifiedNumberCreateParams params = VerifiedNumberCreateParams.builder()
.phoneNumber("+15551234567")
.verificationMethod(VerifiedNumberCreateParams.VerificationMethod.SMS)
.build();
VerifiedNumberCreateResponse verifiedNumber = client.verifiedNumbers().create(params);phone_numberverification_methodGET /verified_numbers/{phone_number}import com.telnyx.sdk.models.verifiednumbers.VerifiedNumberDataWrapper;
import com.telnyx.sdk.models.verifiednumbers.VerifiedNumberRetrieveParams;
VerifiedNumberDataWrapper verifiedNumberDataWrapper = client.verifiedNumbers().retrieve("+15551234567");phone_numberrecord_typeverified_atDELETE /verified_numbers/{phone_number}import com.telnyx.sdk.models.verifiednumbers.VerifiedNumberDataWrapper;
import com.telnyx.sdk.models.verifiednumbers.VerifiedNumberDeleteParams;
VerifiedNumberDataWrapper verifiedNumberDataWrapper = client.verifiedNumbers().delete("+15551234567");phone_numberrecord_typeverified_atPOST /verified_numbers/{phone_number}/actions/verifyverification_codeimport com.telnyx.sdk.models.verifiednumbers.VerifiedNumberDataWrapper;
import com.telnyx.sdk.models.verifiednumbers.actions.ActionSubmitVerificationCodeParams;
ActionSubmitVerificationCodeParams params = ActionSubmitVerificationCodeParams.builder()
.phoneNumber("+15551234567")
.verificationCode("123456")
.build();
VerifiedNumberDataWrapper verifiedNumberDataWrapper = client.verifiedNumbers().actions().submitVerificationCode(params);phone_numberrecord_typeverified_at