The API to retrieve pricing information. Please note the Pricing API is rate limited to one request per second.
Retrieves the pricing information based on the specified country.
GET
https://rest.nexmo.com/account/get-pricing/outbound/:type
Host
https://rest.nexmo.com
GET
/account/get-pricing/outbound/:type
The type of service you wish to retrieve data about: either sms
, sms-transit
or voice
.
Your Nexmo API key.
Your Nexmo API secret.
A two letter country code. For example, CA
.
Two letter country code.
Readable country name.
Readable country name.
The currency that your account is being billed in (by default Euros—EUR
). Can change in the Dashboard to US Dollars—USD.
The default price.
The dialling prefix.
An array of network objects
The type of network: mobile or landline.
The cost to send a message or make a call to this network
The currency used for prices for this network.
The Mobile Network Code of the operator.
The Mobile Country Code and Mobile Network Code combined to give a unique reference for the operator.
The company/organisational name of the operator.
{
"countryCode": "CA",
"countryName": "Canada",
"countryDisplayName": "Canada",
"currency": "EUR",
"defaultPrice": "0.00620000",
"dialingPrefix": "1",
"networks": [
{
"type": "mobile",
"price": "0.00590000",
"currency": "EUR",
"mcc": "302",
"mnc": "530",
"networkCode": "302530",
"networkName": "Keewaytinook Okimakanak"
}
]
}
{
"type": "BAD_REQUEST",
"error_title": "Bad Request",
"invalid_parameters": {
"parameter": "country",
"message": "Is required"
}
}
{
"currency": "EUR",
"code": "401",
"error-code-label": "authentication failed"
}
This endpoint does not support application/json
This endpoint does not support application/json
Retrieves the pricing information for all countries.
GET
https://rest.nexmo.com/account/get-full-pricing/outbound/:type
Host
https://rest.nexmo.com
GET
/account/get-full-pricing/outbound/:type
The type of service you wish to retrieve data about: either sms
, sms-transit
or voice
.
Your Nexmo API key.
Your Nexmo API secret.
The number of countries retrieved.
A list of countries.
Readable country name.
Readable country name.
The currency that your account is being billed in (by default Euros—EUR
). Can change in the Dashboard to US Dollars—USD.
The default price.
The dialling prefix.
An array of network objects
The type of network: mobile or landline.
The cost to send a message or make a call to this network
The currency used for prices for this network.
The Mobile Network Code of the operator.
The Mobile Country Code and Mobile Network Code combined to give a unique reference for the operator.
The company/organisational name of the operator.
{
"count": "243",
"countries": [
{
"countryName": "Canada",
"countryDisplayName": "Canada",
"currency": "EUR",
"defaultPrice": "0.00620000",
"dialingPrefix": "1",
"networks": [
{
"type": "mobile",
"price": "0.00590000",
"currency": "EUR",
"mcc": "302",
"mnc": "530",
"networkCode": "302530",
"networkName": "Keewaytinook Okimakanak"
}
]
}
]
}
{
"type": "BAD_REQUEST",
"error_title": "Bad Request",
"invalid_parameters": {
"parameter": "country",
"message": "Is required"
}
}
{
"currency": "EUR",
"code": "401",
"error-code-label": "authentication failed"
}
This endpoint does not support application/json
This endpoint does not support application/json
Retrieves the pricing information based on the dialing prefix.
GET
https://rest.nexmo.com/account/get-prefix-pricing/outbound/:type
Host
https://rest.nexmo.com
GET
/account/get-prefix-pricing/outbound/:type
The type of service you wish to retrieve data about: either sms
, sms-transit
or voice
.
Your Nexmo API key.
Your Nexmo API secret.
The numerical dialing prefix to look up pricing for. Examples include 44, 1 and so on.
The number of countries retrieved.
A list of countries.
Readable country name.
Readable country name.
The currency that your account is being billed in (by default Euros—EUR
). Can change in the Dashboard to US Dollars—USD.
The default price.
The dialling prefix.
An array of network objects
The type of network: mobile or landline.
The cost to send a message or make a call to this network
The currency used for prices for this network.
The Mobile Network Code of the operator.
The Mobile Country Code and Mobile Network Code combined to give a unique reference for the operator.
The company/organisational name of the operator.
{
"count": "243",
"countries": [
{
"countryName": "Canada",
"countryDisplayName": "Canada",
"currency": "EUR",
"defaultPrice": "0.00620000",
"dialingPrefix": "1",
"networks": [
{
"type": "mobile",
"price": "0.00590000",
"currency": "EUR",
"mcc": "302",
"mnc": "530",
"networkCode": "302530",
"networkName": "Keewaytinook Okimakanak"
}
]
}
]
}
{
"type": "BAD_REQUEST",
"error_title": "Bad Request",
"invalid_parameters": {
"parameter": "country",
"message": "Is required"
}
}
{
"currency": "EUR",
"code": "401",
"error-code-label": "authentication failed"
}
This endpoint does not support application/json
This endpoint does not support application/json