Expected verifications response to a valid request.
required | Array of objects (Verification) |
required | object (Meta) |
import telnyx telnyx.api_key = "YOUR_API_KEY" telnyx.Verification.ByPhoneNumber.list('+13035551234')
{- "data": [
- {
- "call_timeout_secs": 299,
- "created_at": "2020-09-14T17:03:32.965812",
- "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "phone_number": "+13035551234",
- "record_type": "verification",
- "status": "accepted",
- "timeout_secs": 300,
- "type": "sms",
- "updated_at": "2020-09-14T17:03:32.965812",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
], - "meta": {
- "page_number": 2,
- "page_size": 25,
- "total_pages": 3,
- "total_results": 55
}
}
Expected verify response to a valid request.
{- "code": "17686",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
{- "data": {
- "phone_number": "+13035551234",
- "response_code": "accepted"
}
}
Expected verifications response to a valid request.
{- "call_timeout_secs": 30,
- "phone_number": "+13035551234",
- "timeout_secs": 300,
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
{- "data": {
- "call_timeout_secs": 299,
- "created_at": "2020-09-14T17:03:32.965812",
- "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "phone_number": "+13035551234",
- "record_type": "verification",
- "status": "accepted",
- "timeout_secs": 300,
- "type": "sms",
- "updated_at": "2020-09-14T17:03:32.965812",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
}
Expected verifications response to a valid request.
required | object (Verification) | ||||||||||||||||||||
|
{- "phone_number": "+13035551234",
- "timeout_secs": 300,
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
{- "data": {
- "call_timeout_secs": 299,
- "created_at": "2020-09-14T17:03:32.965812",
- "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "phone_number": "+13035551234",
- "record_type": "verification",
- "status": "accepted",
- "timeout_secs": 300,
- "type": "sms",
- "updated_at": "2020-09-14T17:03:32.965812",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
}
amount required | string |
currency required | string (Currencies) The supported currencies. |
payee required | string |
phone_number required | string +E164 formatted phone number. |
timeout_secs | integer The number of seconds the verification code is valid for. |
verify_profile_id required | string <uuid> The identifier of the associated Verify profile. |
Expected verifications response to a valid request.
required | object (Verification) | ||||||||||||||||||||
|
{- "amount": "99.99",
- "currency": "USD",
- "payee": "Acme Corp Inc. LTD",
- "phone_number": "+13035551234",
- "timeout_secs": 300,
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
{- "data": {
- "call_timeout_secs": 299,
- "created_at": "2020-09-14T17:03:32.965812",
- "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "phone_number": "+13035551234",
- "record_type": "verification",
- "status": "accepted",
- "timeout_secs": 300,
- "type": "sms",
- "updated_at": "2020-09-14T17:03:32.965812",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
}
Expected verifications response to a valid request.
required | object (Verification) | ||||||||||||||||||||
|
{- "phone_number": "+13035551234",
- "timeout_secs": 300,
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
{- "data": {
- "call_timeout_secs": 299,
- "created_at": "2020-09-14T17:03:32.965812",
- "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "phone_number": "+13035551234",
- "record_type": "verification",
- "status": "accepted",
- "timeout_secs": 300,
- "type": "sms",
- "updated_at": "2020-09-14T17:03:32.965812",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
}
Expected verifications response to a valid request.
required | object (Verification) | ||||||||||||||||||||
|
import telnyx telnyx.api_key = "YOUR_API_KEY" telnyx.Verification.retrieve(verification_id)
{- "data": {
- "call_timeout_secs": 299,
- "created_at": "2020-09-14T17:03:32.965812",
- "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "phone_number": "+13035551234",
- "record_type": "verification",
- "status": "accepted",
- "timeout_secs": 300,
- "type": "sms",
- "updated_at": "2020-09-14T17:03:32.965812",
- "verify_profile_id": "12ade33a-21c0-473b-b055-b3c836e1c292"
}
}
Gets a paginated list of Verify profiles.
Expected Verify profile response to a valid request.
required | Array of objects (VerifyProfileResponse) |
required | object (Meta) |
import telnyx telnyx.api_key = "YOUR_API_KEY" telnyx.VerifyProfile.list()
{- "data": [
- {
- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "created_at": "2020-09-14T17:03:32.965812",
- "flashcall": {
- "default_verification_timeout_secs": 300
}, - "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "record_type": "verification_profile",
- "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
}, - "updated_at": "2020-09-14T17:03:32.965812",
}
], - "meta": {
- "page_number": 2,
- "page_size": 25,
- "total_pages": 3,
- "total_results": 55
}
}
Creates a new Verify profile to associate verifications with.
Expected Verify profile response to a valid request.
object (VerifyProfileResponse) | |||||||||||||||||||||||||
|
{- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "msg_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "flashcall": {
- "default_verification_timeout_secs": 300
}, - "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
},
}
{- "data": {
- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "created_at": "2020-09-14T17:03:32.965812",
- "flashcall": {
- "default_verification_timeout_secs": 300
}, - "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "record_type": "verification_profile",
- "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
}, - "updated_at": "2020-09-14T17:03:32.965812",
}
}
Expected Verify profile response to a valid request.
object (VerifyProfileResponse) | |||||||||||||||||||||||||
|
import telnyx telnyx.api_key = "YOUR_API_KEY" res = telnyx.VerifyProfile.retrieve(verify_profile_id) res.delete()
{- "data": {
- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "created_at": "2020-09-14T17:03:32.965812",
- "flashcall": {
- "default_verification_timeout_secs": 300
}, - "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "record_type": "verification_profile",
- "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
}, - "updated_at": "2020-09-14T17:03:32.965812",
}
}
Gets a single Verify profile.
Expected Verify profile response to a valid request.
object (VerifyProfileResponse) | |||||||||||||||||||||||||
|
import telnyx telnyx.api_key = "YOUR_API_KEY" telnyx.VerifyProfile.retrieve(verify_profile_id)
{- "data": {
- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "created_at": "2020-09-14T17:03:32.965812",
- "flashcall": {
- "default_verification_timeout_secs": 300
}, - "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "record_type": "verification_profile",
- "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
}, - "updated_at": "2020-09-14T17:03:32.965812",
}
}
Expected Verify profile response to a valid request.
object (VerifyProfileResponse) | |||||||||||||||||||||||||
|
{- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "msg_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "flashcall": {
- "default_verification_timeout_secs": 300
}, - "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
},
}
{- "data": {
- "call": {
- "default_call_timeout_secs": 30,
- "default_verification_timeout_secs": 300,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}."
}, - "created_at": "2020-09-14T17:03:32.965812",
- "flashcall": {
- "default_verification_timeout_secs": 300
}, - "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
- "language": "en-US",
- "name": "Test Profile",
- "psd2": {
- "default_verification_timeout_secs": 300
}, - "record_type": "verification_profile",
- "sms": {
- "default_verification_timeout_secs": 300,
- "messaging_enabled": true,
- "messaging_template": "Hello, this is the Acme Inc verification code you requested: {code}.",
- "rcs_enabled": true,
- "vsms_enabled": true
}, - "updated_at": "2020-09-14T17:03:32.965812",
}
}