Calculate Price

POST

/voice/price

Voice

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://rest.clicksend.com/v3/voice/price' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messages": [
        {
            "body": "Jelly liquorice marshmallow candy carrot cake 4Eyffjs1vL.",
            "custom_string": "this is a test",
            "lang": "en-au",
            "schedule": 1436874701,
            "source": "php",
            "to": "+61411111111",
            "voice": "female"
        },
        {
            "body": "Chocolate bar icing icing oat cake carrot cake jelly cotton MWEvciEPIr.",
            "custom_string": "this is a test",
            "lang": "en-au",
            "list_id": 428,
            "require_input": 1,
            "schedule": 1436876011,
            "source": "php",
            "voice": "female"
        }
    ]
}'

Response Example

{
    "data": {
        "messages": [
            {
                "body": "Jelly liquorice marshmallow candy carrot cake 4Eyffjs1vL.",
                "country": "AU",
                "custom_string": "this is a test",
                "date": 1436871253,
                "from": null,
                "lang": "en-au",
                "machine_detection": 0,
                "message_id": "BF7AD270-0DE2-418B-B606-71D527D9C1AE",
                "message_parts": 1,
                "message_price": 0.07,
                "require_input": 0,
                "schedule": 1436874701,
                "status": "SUCCESS",
                "subaccount_id": 1,
                "to": "+61411111111",
                "to_type": "mobile",
                "user_id": 1,
                "voice": "female"
            },
            {
                "body": "Chocolate bar icing icing oat cake carrot cake jelly cotton MWEvciEPIr.",
                "country": "AU",
                "custom_string": "this is a test",
                "date": 1436871253,
                "from": null,
                "lang": "en-au",
                "machine_detection": 0,
                "message_id": "D0C273EE-816D-4DF2-8E9D-9D9C65F168F3",
                "message_parts": 1,
                "message_price": 0.07,
                "require_input": 1,
                "schedule": 1436876011,
                "status": "SUCCESS",
                "subaccount_id": 1,
                "to": "+61411111111",
                "to_type": "mobile",
                "user_id": 1,
                "voice": "female"
            },
            {
                "body": "Chocolate bar icing icing oat cake carrot cake jelly cotton MWEvciEPIr.",
                "country": "US",
                "custom_string": "this is a test",
                "date": 1436871253,
                "from": null,
                "lang": "en-au",
                "machine_detection": 0,
                "message_id": "A1845B61-C404-4793-8661-97890C19C8A2",
                "message_parts": 1,
                "message_price": 0.07,
                "require_input": 1,
                "schedule": 1436876011,
                "status": "SUCCESS",
                "subaccount_id": 1,
                "to": "+16783270696",
                "to_type": "mobile",
                "user_id": 1,
                "voice": "female"
            },
            {
                "body": "Chocolate bar icing icing oat cake carrot cake jelly cotton MWEvciEPIr.",
                "country": "US",
                "custom_string": "this is a test",
                "date": 1436871253,
                "from": null,
                "lang": "en-au",
                "machine_detection": 0,
                "message_id": "DB545FAA-7325-465F-A696-8BDBFA8C1E49",
                "message_parts": 1,
                "message_price": 0.07,
                "require_input": 1,
                "schedule": 1436876011,
                "status": "SUCCESS",
                "subaccount_id": 1,
                "to": "+16783275492",
                "to_type": "mobile",
                "user_id": 1,
                "voice": "female"
            }
        ],
        "queued_count": 4,
        "total_count": 4,
        "total_price": 0.28
    },
    "http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "Here are your data."
}

Request

Body Params application/json

body

string

required

Your message.

country

string

optional

The country of the recipient.

custom_string

string

optional

Your reference. Will be passed back with all replies and delivery reports.

lang

string

optional

au (string, required) - See section on available languages.

list_id

number

optional

Your list ID if sending to a whole list. Can be used instead of 'to'.

require_input

number

optional

Whether you want to receive a keypress from the call recipient (1 for on, 0 [default] for off)

schedule

number

optional

Leave blank for immediate delivery. Your schedule time as a unix timestamp.

source

string

optional

Your method of sending e.g. 'wordpress', 'php', 'c#'.

string

required

Recipient number in E.164 format or local format (more info).

voice

string

required

Either 'female' or 'male'.

Examples

Responses

🟢200OK

application/json

Body

object {0}

Voice Languages

Get Voice receipts