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

https://api-vout.didww.com/v3

Sandbox

https://api-vout-sandbox.didww.com/v3

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

GET

/v3/lookup/prices

Download outbound call price file

GET

/v3/prices.csv.gz

Check outbound call price file

HEAD

/v3/prices.csv.gz

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 rate, connection_fee and the billing increments.

Track scheduled price changes

Read next_rate, next_connection_fee, next_initial_increment, next_recurring_increment, effective_at and comment.

Find destinations that open or close soon

Look for New Breakout and Removed in the Comment column of the price file.

Keep a local price list

Download the price file and refresh it when Last-Modified changes.