# 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](../index.html) 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](lookup-outbound-call-prices.html).

```
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-outbound-call-price-file.html).

```
GET /v3/prices.csv.gz
HEAD /v3/prices.csv.gz
```

## Data reference

See [Outbound Call Price Object](outbound-call-price-object.html) 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. |

## Related resources

| Resource | Description |
| --- | --- |
| [Outbound Trunks](../../inventory-resources/voice-out-trunks/index.html) | Outbound SIP trunks whose calls are priced by the outbound call pricing plan. |
| [Inbound Call Prices](../inbound-call-prices/index.html) | Prices of inbound calls to toll-free, shared-cost and metered numbers. |
| [Origin-Based Pricing](../../../../billing/billing-and-prices/origin-based-pricing.html) | How the origin of a call affects voice pricing. |
