# Get Inbound Call Price File

Returns the inbound call price file of the plan assigned to the account, or only its headers.

`GET` downloads the prices of the plan as a gzipped CSV file named
`voice_in_prices.csv.gz`. `HEAD` returns the headers of the file without its body, so you
can check whether your copy is current before you download it.

## File Format

The file is a CSV file (UTF-8, LF line endings, a header row) compressed with gzip. Each row
is one price of the plan. Prices are in USD, VAT excluded. They are printed as the lookup
returns them: never rounded, with trailing zeros dropped and at least one decimal kept
(`0.0`, `1.5`, `0.002`).

| Column | Description |
| --- | --- |
| Country | Destination country, by name. Empty for a price of the plan's global country. Same as `country` in the [Inbound Call Price Object](inbound-call-price-object.html). |
| Src country name | Source country of the call, by name. Empty for a price that applies to calls from any country. Same as `src_country_name`. |
| Source type | Calling party category, such as `cellular` or `fixed`. Same as `source_type`. |
| Destination | Destination prefix. Same as `destination`. |
| Rate | Per-minute rate. Empty when the plan rejects calls to the destination. Same as `rate`. |
| Connection fee | Fee charged once per call. Empty when the plan rejects calls to the destination. Same as `connection_fee`. |
| Initial interval | First billing increment, in seconds. Same as `initial_interval`. |
| Next interval | Each following billing increment, in seconds. Same as `next_interval`. |
| Reject calls | `true` when the plan rejects calls to the destination, otherwise `false`. Same as `reject_calls`. |

Example of the file content:

```
Country,Src country name,Source type,Destination,Rate,Connection fee,Initial interval,Next interval,Reject calls
United Kingdom,,cellular,44800,,,60,60,true
United Kingdom,United Kingdom,fixed,4480012,0.0125,0.0,60,60,false
United States,,cellular,1800,0.025,0.0,60,60,false
United States,,fixed,1800,0.018,0.0,60,60,false
```

## Request

Host: `api-vin.didww.com` (Sandbox: `api-vin-sandbox.didww.com`)

HTTP Method: `GET` or `HEAD`

URI Path: `/v3/prices.csv.gz`

The access token must list `api-vin.didww.com` in its `aud`. The `read` scope is
enough.

### Request Headers

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| If-Modified-Since | `string` | No | The `Last-Modified` date of the copy you hold. The file (or, for `HEAD`, its headers) is sent only if it changed after that date. Otherwise the response is `304 Not Modified`. Ignored when the request also carries `If-None-Match`. |

### Response Headers

| Name | Description |
| --- | --- |
| Content-Disposition | `attachment` with the file name `voice_in_prices.csv.gz`. |
| Last-Modified | HTTP date of the later of the last change of the file content and the last change of the account's plan assignment. Send it back in `If-Modified-Since`. |
| Cache-Control | Always `private`. |
| Accept-Ranges | Always `none`. The file is served whole, without byte ranges. |
| Vary | Always `Authorization`. One URL returns each account the file of its own plan. |
| Content-Length | Size of the gzipped file in bytes. Not sent with `304 Not Modified`. |

No `ETag` is sent. A request that carries `If-None-Match` is always answered in full.

## Examples

Download the FileDownload if ChangedCheck the File

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/prices.csv.gz HTTP/1.1
2Host: api-vin.didww.com
3Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET https://api-vin.didww.com/v3/prices.csv.gz -H "Authorization: Bearer [access token]"
```

response

```
1HTTP/1.1 200 OK
2Content-Type: application/gzip
3Content-Disposition: attachment; filename="voice_in_prices.csv.gz"
4Last-Modified: Wed, 14 Oct 2026 06:00:00 GMT
5Cache-Control: private
6Accept-Ranges: none
7Vary: Authorization
8Content-Length: 48213
```

[[DIDWW-API-EXAMPLE-END]]

To save the file with curl, use `-o` with a file name in place of `-i`:

```
curl -o voice_in_prices.csv.gz https://api-vin.didww.com/v3/prices.csv.gz -H "Authorization: Bearer [access token]"
```

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/prices.csv.gz HTTP/1.1
2Host: api-vin.didww.com
3Authorization: Bearer [access token]
4If-Modified-Since: Wed, 14 Oct 2026 06:00:00 GMT
```

curl

```
1curl -i -X GET https://api-vin.didww.com/v3/prices.csv.gz -H "If-Modified-Since: Wed, 14 Oct 2026 06:00:00 GMT" -H "Authorization: Bearer [access token]"
```

response

```
1HTTP/1.1 304 Not Modified
2Content-Disposition: attachment; filename="voice_in_prices.csv.gz"
3Last-Modified: Wed, 14 Oct 2026 06:00:00 GMT
4Cache-Control: private
5Accept-Ranges: none
6Vary: Authorization
```

[[DIDWW-API-EXAMPLE-END]]

With curl, send `HEAD` with `-I` (`--head`), not with `-X HEAD`. `-X HEAD`
changes only the method name: curl still expects the body that `Content-Length`
announces, and the command does not finish normally.

```
curl -I https://api-vin.didww.com/v3/prices.csv.gz -H "Authorization: Bearer [access token]"
```

```
HEAD /v3/prices.csv.gz HTTP/1.1
Host: api-vin.didww.com
Authorization: Bearer [access token]


HTTP/1.1 200 OK
Content-Disposition: attachment; filename="voice_in_prices.csv.gz"
Last-Modified: Wed, 14 Oct 2026 06:00:00 GMT
Cache-Control: private
Accept-Ranges: none
Vary: Authorization
Content-Length: 48213
```

## Other Responses

Error responses to `GET` are JSON:API error documents. Responses to `HEAD` carry no body.

| Code | Success | Description |
| --- | --- | --- |
| 304 | Yes | The file has not changed since the `If-Modified-Since` date. The response carries the headers of the `200` response except `Content-Length`, and no body. |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35). The bearer token was refused. The response carries `WWW-Authenticate: Bearer error="invalid_token"`. |
| 403 | No | The token does not carry the `read` scope (title `Insufficient scope`). The response carries `WWW-Authenticate: Bearer error="insufficient_scope"`. |
| 404 | No | No price plan is assigned to the account (`price_plan_not_assigned`). |
| 429 | No | The request budget of the account on this service for the current window is spent (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
| 503 | No | The file could not be served, for example because the assigned plan has no generated file yet (`serving_failure`). `Retry-After` gives the number of seconds to wait. |
