Get Rates
Retrieve voice rates for your account. This endpoint returns a paginated list of tariff rates applied to voice traffic, including destination prefixes, effective dates, routing prefixes, and rate values. Rates define the cost structure used for call billing and may vary based on tariff plans, destination codes, and effective time periods.
Query Parameters
Optional parameter. Filters rates by blocking status. true - blocked destinations only; false - active destinations only.
Optional parameter. Filters rates by destination country code. Accepts ISO Alpha-3 country codes. Examples: "DEU", "GBR", "ESP".
Optional parameter. Filters rates by destination name. Partial matching is supported. Example: "Germany".
Optional parameter. Returns only rates effective on or after the specified date. Format: RFC3339 (2026-05-21T16:04:00Z).
Pagination parameters. Accepts page number. Pagination starts on page=1. If parameter is not provided, the default value of 1 will be set.
Pagination parameter. Accepts the size of page for pagination. Minimal page size is 1. If parameter is not provided, the default value of 10 will be set.
Optional parameter. Filters rates by destination dialing prefix. Examples: "49", "44", "380".
Optional parameter. Returns only rates with value greater than or equal to the provided amount.
Optional parameter. Returns only rates with value less than or equal to the provided amount.
Ordering parameter. Defines by which field the data will be sorted. If parameter is not provided, will be used entity's default ordering. To use entity's default sorting, pass _default as value.
"_default" | "id" | "prefix" | "effective_from" | "direction_code" | "rate" | "blocked" | "tech_prefix" | "tariff_id" | "dst_name" | "trf_name"Ordering parameter. Defines the order of sorting (asc or desc). If parameter is not provided, will be used entity's default ordering.
"asc" | "desc"Optional parameter. Filters rates belonging to a specific tariff. The tariff ID can be obtained from GET /api/v1/voice/billing/tariffs.
1 <= valueOptional parameter. Allows filtering by multiple tariff selectors. Each value must be provided in format <tariff_id>,<tech_prefix>. Examples: 11,111#, 15,222#. If technical prefix is not required, the format <tariff_id> may be used.
Optional parameter. Filters rates belonging to a specific technical routing prefix. Example: "111#". Can be obtained via GET /api/v1/voice/billing/tariffs.
Header Parameters
Your API token
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://dev-refactor-api-e.voipenv.uk/api/v1/voice/billing/rates" \ -H "Authorization: string"{
"data": [
{
"blocked": true,
"direction_code": "string",
"dst_name": "string",
"effective_from": "string",
"increment_s": "string",
"min_time": "string",
"prefix": "string",
"rate": 0,
"tariff_id": 0,
"tech_prefix": "string",
"trf_name": "string"
}
],
"page": 0,
"page_size": 0,
"total": 0,
"total_pages": 0
}{
"code": 0,
"error_details": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"message": "string",
"request_id": "string",
"status": "error"
}{
"code": 0,
"error_details": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"message": "string",
"request_id": "string",
"status": "error"
}{
"code": 0,
"error_details": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"message": "string",
"request_id": "string",
"status": "error"
}
