Requirements for ordering a virtual number

Address (National)

A valid, real-world physical address located in the same country as the phone number being purchased. The address must include street name and number, postal or ZIP code, city, region or province (where applicable), and country. The address does not need to match the specific city or area code of the number; any address within the national borders is acceptable. P.O. boxes, virtual office addresses, mailbox-only services, and addresses outside the country of the phone number are not acceptable. The address should match the address shown on supporting identity or business registration documents where those are also required.

Acceptance criteria
{"case_sensitive":true}

Example
For a Spanish phone number: Calle de Alcalá 42, 28014 Madrid, Spain. For a German phone number: Friedrichstraße 123, 10117 Berlin, Germany. The address must be a deliverable physical location, not a P.O. box or virtual mailbox.

Contact Information (Name, Business Name, Phone Number)

Contact information for the business or end user, including: (1) the name of the contact person (full given name and family name), (2) the business name when the end user is a business (registered legal name where applicable; may be omitted or stated as 'N/A' for individual end users), and (3) one or more contact phone numbers where the business or end user can be reached. Contact person name and at least one phone number are mandatory; business name is required only when the end user is a business entity. Phone numbers should be in international E.164 format where possible.

Acceptance criteria
{"case_sensitive":true}

Example
Contact: Maria García López | Business: Bloom & Petal Florist Ltd. | Phone: +34 612 345 678. For individual end users: Contact: John Smith | Business: N/A | Phone: +1 (555) 123-4567.

Proof of Address (Local), with Local Activity Evidence

Provide a document dated within the past 3 months that shows the supplied local service address in the country of the phone number. Accepted documents include bank statements, government letters, tax letters, invoices, bills, utility bills, or other official documents that verify the end user’s local address. The document must show the individual’s name for personal end users, or the business name for business end users. Bank statements are an acceptable form of address verification when they show the required name, local service address, issuer, and date within the past 3 months. Leases, rental agreements, or other documents with occupancy or contract terms are not accepted.

Acceptance criteria
{"case_sensitive":true}

Example
A recent bank statement, government letter, tax notice, invoice, bill, or utility bill showing the individual’s name or business name and the supplied local service address, dated within the past 90 days.

Proof of Address (National), Recent Utility Bill or Invoice

A document evidencing the customer's physical address within the same country as the phone number being purchased, dated within the past 3 months. Acceptable documents include utility bills (electricity, water, gas, internet, landline telephone), bank statements, tax notices, or government-issued correspondence. The document must clearly show (1) the full name of the individual or registered business name, (2) the complete physical address (street, postal code, city, country), and (3) the document issue date. The document must be submitted as a PDF or clear color scan. Screenshots, handwritten documents, mobile phone bills (when not the proof of residence), and bills older than 3 months are not acceptable.

Acceptance criteria
{"case_sensitive":true}

Example
A PDF of an Iberdrola electricity bill dated within the last 90 days, addressed to the customer at a Spanish residential address, for a Spain phone number order. The bill must show the customer's name, full service address, and the issuer's logo and billing date.

Contact Information (Name, Business Name, Phone Number)

Contact information for the business or end user, including: (1) the name of the contact person (full given name and family name), (2) the business name when the end user is a business (registered legal name where applicable; may be omitted or stated as 'N/A' for individual end users), and (3) one or more contact phone numbers where the business or end user can be reached. Contact person name and at least one phone number are mandatory; business name is required only when the end user is a business entity. Phone numbers should be in international E.164 format where possible.

Acceptance criteria
{"case_sensitive":true}

Example
Contact: Maria García López | Business: Bloom & Petal Florist Ltd. | Phone: +34 612 345 678. For individual end users: Contact: John Smith | Business: N/A | Phone: +1 (555) 123-4567.

List of In-Service Australian Mobile Numbers (Purchaser Disclosure)

A list of all other activated prepaid mobile carriage services (Australian mobile numbers) currently supplied to the same Purchaser, as required by Australian regulations. If the Purchaser has no other in-service prepaid Australian mobile numbers, the response should clearly state 'None'. Numbers must be in international E.164 format starting with +61 followed by 9 digits. Australian mobile numbers begin with +614.

Acceptance criteria
{"case_sensitive":true}

Example
+61412345678, +61423456789, +61434567890. Or, if the Purchaser has no other in-service AU mobile numbers: 'None'. Numbers must be in +61 international format.

Purchaser or Service Activator Confirmation (AU Mobile)

Confirmation, required by Australian regulations, of whether the end user is the Purchaser or the Service Activator of the prepaid mobile carriage service. PURCHASER means the individual who pays for the service during the sale transaction (or, where a carriage service provider extends a free invitation, the person who accepts the invitation). SERVICE ACTIVATOR means the person who requests activation of a prepaid mobile carriage service from the offering carriage service provider. The submitted value must clearly indicate one of the two roles.

Acceptance criteria
{"case_sensitive":true}

Example
Purchaser (the individual who paid for the prepaid SIM at the point of sale). Or: Service Activator (the individual who activated the prepaid service via the carrier's portal or activation line).

Physical Address Within the Country of the Phone Number (National)

A valid, real-world physical address located in the same country as the phone number being purchased. The address must include street name and number, postal or ZIP code, city, region or province (where applicable), and country. The address does not need to match the specific city or area code of the number; any address within the national borders is acceptable. P.O. boxes, virtual office addresses, mailbox-only services, and addresses outside the country of the phone number are not acceptable. The address should match the address shown on supporting identity or business registration documents where those are also required.

Acceptance criteria
{"case_sensitive":true}

Example
For a Spanish phone number: Calle de Alcalá 42, 28014 Madrid, Spain. For a German phone number: Friedrichstraße 123, 10117 Berlin, Germany. The address must be a deliverable physical location, not a P.O. box or virtual mailbox.

Australian Mobile ID Verification (Onfido Process)

An identity verification process required for Australian Mobile DIDs, conducted via Telnyx's partner Onfido. The customer (or Telnyx on the customer's behalf) generates a unique verification link and shares it with the end user. The end user accesses Onfido's secure portal via the link, uploads government-issued identification documents, and completes a real-time selfie/liveness check. The Telnyx team reviews the verification result; if Onfido approves and the documents pass review, this requirement is marked complete. This is an action-type requirement: no document is uploaded directly by the customer; the verification is completed via the Onfido flow.

Acceptance criteria
{"case_sensitive":true}

Example
Generate an Onfido verification link via Telnyx and provide it to the end user. The end user uploads their Australian government-issued ID and completes a liveness selfie. The verification status updates automatically once Onfido completes its checks and the Telnyx team reviews the result.

End User Date of Birth (ISO 8601 Format)

The end user's full date of birth, submitted in ISO 8601 format (YYYY-MM-DD). The value must be a real calendar date, must indicate the person is at least 18 years old as of the submission date, and must match the date of birth shown on any accompanying identity document. Future dates and dates implying the person is a minor are not acceptable.

Acceptance criteria
{"regex":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$","case_sensitive":true}

Example
2002-06-15 (June 15, 2002). The format must be exactly four-digit year, two-digit month, two-digit day, separated by hyphens. Formats such as 06/15/2002, 15-06-2002, or 'June 15 2002' are not acceptable.

Contact Information (Name, Business Name, Phone Number)

Contact information for the business or end user, including: (1) the name of the contact person (full given name and family name), (2) the business name when the end user is a business (registered legal name where applicable; may be omitted or stated as 'N/A' for individual end users), and (3) one or more contact phone numbers where the business or end user can be reached. Contact person name and at least one phone number are mandatory; business name is required only when the end user is a business entity. Phone numbers should be in international E.164 format where possible.

Acceptance criteria
{"case_sensitive":true}

Example
Contact: Maria García López | Business: Bloom & Petal Florist Ltd. | Phone: +34 612 345 678. For individual end users: Contact: John Smith | Business: N/A | Phone: +1 (555) 123-4567.

Local Business Registration Certificate (Business Use Only)

An official company registration or incorporation certificate issued by the government registry of the same country as the phone number being purchased. Required for business end users only. The document must clearly show the registered legal company name (matching the order), the unique company registration or incorporation number, the date of registration, the registered business address, and the issuing authority. Should be a clear color scan or original PDF in the local language or English, dated within the past 3 months unless a different timeframe applies at the country level.

Acceptance criteria
{"case_sensitive":true}

Example
For a France phone number: an Extrait Kbis from the Greffe du Tribunal de Commerce. For a UK phone number: a Companies House Certificate of Incorporation. The certificate must display the legal company name, registration number, registration date, and registered office address.

Local Government-Issued ID or Passport Copy (issued by country of phone number)

A clear color copy of a valid, unexpired government-issued identity document for the individual associated with the phone number order, issued by the same country as the phone number. Acceptable documents include a national identity card (front and back) or the biographical data page of a passport. The copy must clearly display the holder's full legal name, photograph, date of birth, document number, issuing authority, issue date, and expiration date. Documents issued by countries other than the order's country are not accepted under this requirement.

Acceptance criteria
{"case_sensitive":true}

Example
A color scan of a Spanish DNI (front and back) for a Spain phone number order, a French Carte Nationale d'Identité for a France order, or the photo and data page of a German Reisepass for a Germany order. All security features and personal details must be legible, and the document must not be expired as of the submission date.

Proof of Address (Local), with Local Activity Evidence

Provide a document dated within the past 3 months that shows the supplied local service address in the country of the phone number. Accepted documents include bank statements, government letters, tax letters, invoices, bills, utility bills, or other official documents that verify the end user’s local address. The document must show the individual’s name for personal end users, or the business name for business end users. Bank statements are an acceptable form of address verification when they show the required name, local service address, issuer, and date within the past 3 months. Leases, rental agreements, or other documents with occupancy or contract terms are not accepted.

Acceptance criteria
{"case_sensitive":true}

Example
A recent bank statement, government letter, tax notice, invoice, bill, or utility bill showing the individual’s name or business name and the supplied local service address, dated within the past 90 days.

Address Matching the DID Area Code (Geographic Match)

A physical address that matches the geographic area covered by the phone number's area code. The address must include street name and number, postal/ZIP code, city, and country, and the city/region of the address must fall within the geographic area assigned to the DID's area code. Addresses outside the area code's geographic region are not acceptable for this requirement; a different (broader, national-level) address requirement must be selected if the customer cannot provide a matching local address.

Acceptance criteria
{"case_sensitive":true}

Example
311 W Superior St, Chicago, IL 60654 (matches Chicago area code 312). For a +44 20 (Greater London) DID: an address within Greater London such as '60 Holborn Viaduct, London EC1A 2FD'. The address must lie within the area code's geographic boundaries.

Proof of Address (National), Recent Utility Bill or Invoice

A document evidencing the customer's physical address within the same country as the phone number being purchased, dated within the past 3 months. Acceptable documents include utility bills (electricity, water, gas, internet, landline telephone), bank statements, tax notices, or government-issued correspondence. The document must clearly show (1) the full name of the individual or registered business name, (2) the complete physical address (street, postal code, city, country), and (3) the document issue date. The document must be submitted as a PDF or clear color scan. Screenshots, handwritten documents, mobile phone bills (when not the proof of residence), and bills older than 3 months are not acceptable.

Acceptance criteria
{"case_sensitive":true}

Example
A PDF of an Iberdrola electricity bill dated within the last 90 days, addressed to the customer at a Spanish residential address, for a Spain phone number order. The bill must show the customer's name, full service address, and the issuer's logo and billing date.

Contact Information (Name, Business Name, Phone Number)

Contact information for the business or end user, including: (1) the name of the contact person (full given name and family name), (2) the business name when the end user is a business (registered legal name where applicable; may be omitted or stated as 'N/A' for individual end users), and (3) one or more contact phone numbers where the business or end user can be reached. Contact person name and at least one phone number are mandatory; business name is required only when the end user is a business entity. Phone numbers should be in international E.164 format where possible.

Acceptance criteria
{"case_sensitive":true}

Example
Contact: Maria García López | Business: Bloom & Petal Florist Ltd. | Phone: +34 612 345 678. For individual end users: Contact: John Smith | Business: N/A | Phone: +1 (555) 123-4567.

Local Government-Issued ID or Passport Copy (issued by country of phone number)

A clear color copy of a valid, unexpired government-issued identity document for the individual associated with the phone number order, issued by the same country as the phone number. Acceptable documents include a national identity card (front and back) or the biographical data page of a passport. The copy must clearly display the holder's full legal name, photograph, date of birth, document number, issuing authority, issue date, and expiration date. Documents issued by countries other than the order's country are not accepted under this requirement.

Acceptance criteria
{"case_sensitive":true}

Example
A color scan of a Spanish DNI (front and back) for a Spain phone number order, a French Carte Nationale d'Identité for a France order, or the photo and data page of a German Reisepass for a Germany order. All security features and personal details must be legible, and the document must not be expired as of the submission date.

Local Government-Issued ID/Passport Copy or Local Company Registration Certificate

Either (a) a clear color copy of a valid, unexpired government-issued ID or passport for the individual end user (issued by the same country as the phone number); OR (b) a copy of the company registration or incorporation certificate issued by the local government registry of that same country. The choice depends on whether the end user is an individual (option a) or a business (option b). Documents from countries other than the phone number's country are not acceptable. ID/passports must show full name, photograph, date of birth, document number, and expiration date and must not be expired. Business certificates must show legal name, registration number, registration date, and registered address.

Acceptance criteria
{"case_sensitive":true}

Example
For an individual end user with a Spanish phone number: a color scan of both sides of a Spanish DNI. For a business end user with a Spanish phone number: a copy of the company's registration certificate from the Spanish Registro Mercantil.

Physical Address Within the Country of the Phone Number (National)

A valid, real-world physical address located in the same country as the phone number being purchased. The address must include street name and number, postal or ZIP code, city, region or province (where applicable), and country. The address does not need to match the specific city or area code of the number; any address within the national borders is acceptable. P.O. boxes, virtual office addresses, mailbox-only services, and addresses outside the country of the phone number are not acceptable. The address should match the address shown on supporting identity or business registration documents where those are also required.

Acceptance criteria
{"case_sensitive":true}

Example
For a Spanish phone number: Calle de Alcalá 42, 28014 Madrid, Spain. For a German phone number: Friedrichstraße 123, 10117 Berlin, Germany. The address must be a deliverable physical location, not a P.O. box or virtual mailbox.

Contact Information (Name, Business Name, Phone Number)

Contact information for the business or end user, including: (1) the name of the contact person (full given name and family name), (2) the business name when the end user is a business (registered legal name where applicable; may be omitted or stated as 'N/A' for individual end users), and (3) one or more contact phone numbers where the business or end user can be reached. Contact person name and at least one phone number are mandatory; business name is required only when the end user is a business entity. Phone numbers should be in international E.164 format where possible.

Acceptance criteria
{"case_sensitive":true}

Example
Contact: Maria García López | Business: Bloom & Petal Florist Ltd. | Phone: +34 612 345 678. For individual end users: Contact: John Smith | Business: N/A | Phone: +1 (555) 123-4567.

Local Business Registration Certificate (Business Use Only)

An official company registration or incorporation certificate issued by the government registry of the same country as the phone number being purchased. Required for business end users only. The document must clearly show the registered legal company name (matching the order), the unique company registration or incorporation number, the date of registration, the registered business address, and the issuing authority. Should be a clear color scan or original PDF in the local language or English, dated within the past 3 months unless a different timeframe applies at the country level.

Acceptance criteria
{"case_sensitive":true}

Example
For a France phone number: an Extrait Kbis from the Greffe du Tribunal de Commerce. For a UK phone number: a Companies House Certificate of Incorporation. The certificate must display the legal company name, registration number, registration date, and registered office address.

Proof of Address (Local), with Local Activity Evidence

Provide a document dated within the past 3 months that shows the supplied local service address in the country of the phone number. Accepted documents include bank statements, government letters, tax letters, invoices, bills, utility bills, or other official documents that verify the end user’s local address. The document must show the individual’s name for personal end users, or the business name for business end users. Bank statements are an acceptable form of address verification when they show the required name, local service address, issuer, and date within the past 3 months. Leases, rental agreements, or other documents with occupancy or contract terms are not accepted.

Acceptance criteria
{"case_sensitive":true}

Example
A recent bank statement, government letter, tax notice, invoice, bill, or utility bill showing the individual’s name or business name and the supplied local service address, dated within the past 90 days.

Address Matching the DID Area Code (Geographic Match)

A physical address that matches the geographic area covered by the phone number's area code. The address must include street name and number, postal/ZIP code, city, and country, and the city/region of the address must fall within the geographic area assigned to the DID's area code. Addresses outside the area code's geographic region are not acceptable for this requirement; a different (broader, national-level) address requirement must be selected if the customer cannot provide a matching local address.

Acceptance criteria
{"case_sensitive":true}

Example
311 W Superior St, Chicago, IL 60654 (matches Chicago area code 312). For a +44 20 (Greater London) DID: an address within Greater London such as '60 Holborn Viaduct, London EC1A 2FD'. The address must lie within the area code's geographic boundaries.

Passport or ID Copy in PDF Format

A clear color PDF copy of a valid, unexpired government-issued passport or national identity card belonging to the end user (for personal accounts) or the authorized representative (for business accounts). For ID cards, both front and back must be included in the PDF. The PDF must clearly show the holder's full legal name, photograph, date of birth, document number, issuing authority, and expiration date. The document must not be expired as of the submission date. Image formats other than PDF (such as JPG or PNG) and black-and-white copies are not acceptable for this requirement.

Acceptance criteria
{"case_sensitive":true}

Example
A color PDF of the biographical data page of a passport, or a color PDF combining both sides of a national ID card. All details must be legible and the document must be a valid (unexpired) PDF, not a photograph or low-resolution scan.

Belgian VAT Number

A valid Belgian VAT registration number (BTW-nummer / numéro de TVA) issued by the Belgian tax authority. The submitted value must follow the format 'BE' followed by 10 digits, where the first digit is 0 or 1. The VAT number must correspond to the business named on the order. Belgian VAT numbers from companies that have been deregistered are not acceptable.

Acceptance criteria
{"case_sensitive":true}

Example
BE0780.793.702 or BE0780793702 (both dotted and undotted formats acceptable). The country prefix must be 'BE' and the numeric portion must be exactly 10 digits.

Contact Information (Name, Business Name, Phone Number)

Contact information for the business or end user, including: (1) the name of the contact person (full given name and family name), (2) the business name when the end user is a business (registered legal name where applicable; may be omitted or stated as 'N/A' for individual end users), and (3) one or more contact phone numbers where the business or end user can be reached. Contact person name and at least one phone number are mandatory; business name is required only when the end user is a business entity. Phone numbers should be in international E.164 format where possible.

Acceptance criteria
{"case_sensitive":true}

Example
Contact: Maria García López | Business: Bloom & Petal Florist Ltd. | Phone: +34 612 345 678. For individual end users: Contact: John Smith | Business: N/A | Phone: +1 (555) 123-4567.

Local Business Registration Certificate (Business Use Only)

An official company registration or incorporation certificate issued by the government registry of the same country as the phone number being purchased. Required for business end users only. The document must clearly show the registered legal company name (matching the order), the unique company registration or incorporation number, the date of registration, the registered business address, and the issuing authority. Should be a clear color scan or original PDF in the local language or English, dated within the past 3 months unless a different timeframe applies at the country level.

Acceptance criteria
{"case_sensitive":true}

Example
For a France phone number: an Extrait Kbis from the Greffe du Tribunal de Commerce. For a UK phone number: a Companies House Certificate of Incorporation. The certificate must display the legal company name, registration number, registration date, and registered office address.

Physical Address Within the Country of the Phone Number (National)

A valid, real-world physical address located in the same country as the phone number being purchased. The address must include street name and number, postal or ZIP code, city, region or province (where applicable), and country. The address does not need to match the specific city or area code of the number; any address within the national borders is acceptable. P.O. boxes, virtual office addresses, mailbox-only services, and addresses outside the country of the phone number are not acceptable. The address should match the address shown on supporting identity or business registration documents where those are also required.

Acceptance criteria
{"case_sensitive":true}

Example
For a Spanish phone number: Calle de Alcalá 42, 28014 Madrid, Spain. For a German phone number: Friedrichstraße 123, 10117 Berlin, Germany. The address must be a deliverable physical location, not a P.O. box or virtual mailbox.

Proof of Address (Recent Bill or Invoice)

A document evidencing the customer's physical address, issued within the past 3 months. Acceptable documents include utility bills (electricity, water, gas, internet, landline telephone), invoices from the current telecommunications provider, or insurance policy documents. The document must clearly show (1) the full name of the individual or registered business name (matching the order), (2) the complete physical address (street, postal code, city, country), and (3) the document issue date. Mobile phone bills, screenshots, handwritten documents, and bills older than 3 months are not acceptable.

Acceptance criteria
{"case_sensitive":true,"time_limit":"3 Months from request"}

Example
A PDF of the latest invoice from the customer's current phone provider, addressed to the end user at their registered address, with an issue date within the past 90 days; or an electricity utility bill with the same.

Contact Email Address of End Client

A valid email address for the end client (the natural person or business that will use the phone number), used for compliance follow-up. The submitted value must be a syntactically valid email address (max 150 characters) and should reach the end client directly. Generic or shared role-based addresses (e.g., info@, contact@) are acceptable but a personal address tied to the named end client is preferred.

Acceptance criteria
{"max_length":150,"case_sensitive":true,"min_length":1}

Example
maria.garcia@bloomandpetal.com or contact@acme-coffee.de. The address must be syntactically valid (matching the standard email format) and should be a working address.

Passport or ID Copy in PDF Format

A clear color PDF copy of a valid, unexpired government-issued passport or national identity card belonging to the end user (for personal accounts) or the authorized representative (for business accounts). For ID cards, both front and back must be included in the PDF. The PDF must clearly show the holder's full legal name, photograph, date of birth, document number, issuing authority, and expiration date. The document must not be expired as of the submission date. Image formats other than PDF (such as JPG or PNG) and black-and-white copies are not acceptable for this requirement.

Acceptance criteria
{"case_sensitive":true}

Example
A color PDF of the biographical data page of a passport, or a color PDF combining both sides of a national ID card. All details must be legible and the document must be a valid (unexpired) PDF, not a photograph or low-resolution scan.

Belgian VAT Number

A valid Belgian VAT registration number (BTW-nummer / numéro de TVA) issued by the Belgian tax authority. The submitted value must follow the format 'BE' followed by 10 digits, where the first digit is 0 or 1. The VAT number must correspond to the business named on the order. Belgian VAT numbers from companies that have been deregistered are not acceptable.

Acceptance criteria
{"case_sensitive":true}

Example
BE0780.793.702 or BE0780793702 (both dotted and undotted formats acceptable). The country prefix must be 'BE' and the numeric portion must be exactly 10 digits.