team-telnyx Telnyx Numbers Compliance - Python
Installation
pip install telnyx
Setup
import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
All examples below assume client is already initialized as shown above.
Retrieve Bundles
Get all allowed bundles.
GET /bundle_pricing/billing_bundles
page = client.bundle_pricing.billing_bundles.list()
page = page.data[0]
print(page.id)
Get Bundle By Id
Get a single bundle by ID.
GET /bundle_pricing/billing_bundles/{bundle_id}
billing_bundle = client.bundle_pricing.billing_bundles.retrieve(
bundle_id="8661948c-a386-4385-837f-af00f40f111a",
)
print(billing_bundle.data)
Get User Bundles
Get a paginated list of user bundles.
GET /bundle_pricing/user_bundles
page = client.bundle_pricing.user_bundles.list()
page = page.data[0]
print(page.id)
Create User Bundles
Creates multiple user bundles for the user.
POST /bundle_pricing/user_bundles/bulk
user_bundle = client.bundle_pricing.user_bundles.create()
print(user_bundle.data)
Get Unused User Bundles
Returns all user bundles that aren't in use.
GET /bundle_pricing/user_bundles/unused
response = client.bundle_pricing.user_bundles.list_unused()
print(response.data)
Get User Bundle by Id
Retrieves a user bundle by its ID.
GET /bundle_pricing/user_bundles/{user_bundle_id}
user_bundle = client.bundle_pricing.user_bundles.retrieve(
user_bundle_id="ca1d2263-d1f1-43ac-ba53-248e7a4bb26a",
)
print(user_bundle.data)
Deactivate User Bundle
Deactivates a user bundle by its ID.
DELETE /bundle_pricing/user_bundles/{user_bundle_id}
response = client.bundle_pricing.user_bundles.deactivate(
user_bundle_id="ca1d2263-d1f1-43ac-ba53-248e7a4bb26a",
)
print(response.data)
Get User Bundle Resources
Retrieves the resources of a user bundle by its ID.
GET /bundle_pricing/user_bundles/{user_bundle_id}/resources
response = client.bundle_pricing.user_bundles.list_resources(
user_bundle_id="ca1d2263-d1f1-43ac-ba53-248e7a4bb26a",
)
print(response.data)
List all document links
List all documents links ordered by created_at descending.
GET /document_links
page = client.document_links.list()
page = page.data[0]
print(page.id)
List all documents
List all documents ordered by created_at descending.
GET /documents
page = client.documents.list()
page = page.data[0]
print(page.id)
Upload a document
Upload a document.Uploaded files must be linked to a service within 30 minutes or they will be automatically deleted.
POST /documents
response = client.documents.upload_json(
document={},
)
print(response.data)
Retrieve a document
Retrieve a document.
GET /documents/{id}
document = client.documents.retrieve(
"6a09cdc3-8948-47f0-aa62-74ac943d6c58",
)
print(document.data)
Update a document
Update a document.
PATCH /documents/{id}
document = client.documents.update(
document_id="6a09cdc3-8948-47f0-aa62-74ac943d6c58",
)
print(document.data)
Delete a document
Delete a document.A document can only be deleted if it's not linked to a service.
DELETE /documents/{id}
document = client.documents.delete(
"6a09cdc3-8948-47f0-aa62-74ac943d6c58",
)
print(document.data)
Download a document
Download a document.
GET /documents/{id}/download
response = client.documents.download(
"6a09cdc3-8948-47f0-aa62-74ac943d6c58",
)
print(response)
content = response.read()
print(content)
Generate a temporary download link for a document
Generates a temporary pre-signed URL that can be used to download the document directly from the storage backend without authentication.
GET /documents/{id}/download_link
response = client.documents.generate_download_link(
"550e8400-e29b-41d4-a716-446655440000",
)
print(response.data)
List all requirements
List all requirements with filtering, sorting, and pagination
GET /requirements
page = client.requirements.list()
page = page.data[0]
print(page.id)
Retrieve a document requirement
Retrieve a document requirement record
GET /requirements/{id}
requirement = client.requirements.retrieve(
"a9dad8d5-fdbd-49d7-aa23-39bb08a5ebaa",
)
print(requirement.data)
List all requirement types
List all requirement types ordered by created_at descending
GET /requirement_types
requirement_types = client.requirement_types.list()
print(requirement_types.data)
Retrieve a requirement types
Retrieve a requirement type by id
GET /requirement_types/{id}
requirement_type = client.requirement_types.retrieve(
"a38c217a-8019-48f8-bff6-0fdd9939075b",
)
print(requirement_type.data)
Retrieve regulatory requirements
GET /regulatory_requirements
regulatory_requirement = client.regulatory_requirements.retrieve()
print(regulatory_requirement.data)
List requirement groups
GET /requirement_groups
requirement_groups = client.requirement_groups.list()
print(requirement_groups)
Create a new requirement group
POST /requirement_groups — Required: country_code, phone_number_type, action
requirement_group = client.requirement_groups.create(
action="ordering",
country_code="US",
phone_number_type="local",
)
print(requirement_group.id)
Get a single requirement group by ID
GET /requirement_groups/{id}
requirement_group = client.requirement_groups.retrieve(
"id",
)
print(requirement_group.id)
Update requirement values in requirement group
PATCH /requirement_groups/{id}
requirement_group = client.requirement_groups.update(
id="id",
)
print(requirement_group.id)
Delete a requirement group by ID
DELETE /requirement_groups/{id}
requirement_group = client.requirement_groups.delete(
"id",
)
print(requirement_group.id)
Submit a Requirement Group for Approval
POST /requirement_groups/{id}/submit_for_approval
requirement_group = client.requirement_groups.submit_for_approval(
"id",
)
print(requirement_group.id)
List all Verified Numbers
Gets a paginated list of Verified Numbers.
GET /verified_numbers
page = client.verified_numbers.list()
page = page.data[0]
print(page.phone_number)
Request phone number verification
Initiates phone number verification procedure.
POST /verified_numbers — Required: phone_number, verification_method
verified_number = client.verified_numbers.create(
phone_number="+15551234567",
verification_method="sms",
)
print(verified_number.phone_number)
Retrieve a verified number
GET /verified_numbers/{phone_number}
verified_number_data_wrapper = client.verified_numbers.retrieve(
"+15551234567",
)
print(verified_number_data_wrapper.data)
Delete a verified number
DELETE /verified_numbers/{phone_number}
verified_number_data_wrapper = client.verified_numbers.delete(
"+15551234567",
)
print(verified_number_data_wrapper.data)
Submit verification code
POST /verified_numbers/{phone_number}/actions/verify — Required: verification_code
verified_number_data_wrapper = client.verified_numbers.actions.submit_verification_code(
phone_number="+15551234567",
verification_code="123456",
)
print(verified_number_data_wrapper.data)