Outbound Call Prices#
Use the Outbound Call Prices resource to read what outbound calls to each destination cost, as priced by the outbound call pricing plan assigned to your DIDWW account, together with the price changes that are already scheduled.
Outbound call prices are served by the Outbound Call Rates service:
Environment |
Base URL |
|---|---|
Production |
|
Sandbox |
|
The access token must list api-vout.didww.com in its aud, on the sandbox host as
well. A token with the read scope is enough. See Prices Resources for
authentication, common rules and errors.
An outbound call price applies to a destination prefix under a set of routing conditions. Each
price has a category (International, Origin based or Local). Prices are in
USD, VAT excluded. The outbound call pricing service is the only prices service that also returns the next price of
a destination: the next_ attributes, effective_at and comment describe a change
that is already scheduled.
Endpoints#
Action |
Method |
Endpoint |
|---|---|---|
Look up outbound call prices |
|
|
Download outbound call price file |
|
|
Check outbound call price file |
|
|
Look up outbound call prices#
Returns the prices that cover one number: for every set of routing conditions that the plan prices, the price of the longest prefix covering the number.
filter[number] is the only supported filter.
See Look up Outbound Call Prices.
GET /v3/lookup/prices?filter[number]=493012345678
Download outbound call price file#
Downloads the whole price list of the plan as voice_out_prices.csv.gz, including the
prefixes that open or are removed within the next 30 days. Use HEAD or
If-Modified-Since to check whether your copy is current.
See Get Outbound Call Price File.
GET /v3/prices.csv.gz
HEAD /v3/prices.csv.gz
Data reference#
See Outbound Call Price Object for all attributes returned by a
lookup, and the comment and category values.
Common outbound call pricing use cases#
Use case |
Description |
|---|---|
Show the price of a call before it is made |
Look up the number and read |
Track scheduled price changes |
Read |
Find destinations that open or close soon |
Look for |
Keep a local price list |
Download the price file and refresh it when |