---
title: "Get Phone Number Price"
api: "GET /v1/api/twilio/phone-number-price"
description: "Get the monthly price of a phone number by country and type."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

<Note>
Your role needs the `phone_number:view` permission. Otherwise the request fails with `403 {"error": "Insufficient permissions"}`.
</Note>

## Headers
<ParamField header="x-workspace-id" type="string" required>
Workspace identifier for the API.
</ParamField>

## Query Parameters

<ParamField query="country" type="string" required>
Country code, for example `US`, `CA`, `AU` or `GB`.
</ParamField>

<ParamField query="type" type="string" required>
`local` or `mobile`. Toll-free numbers are not sold through the API: `tollFree` returns `403` with code `TOLL_FREE_NOT_AVAILABLE`.
</ParamField>

## Response Fields

<ResponseField name="country" type="string">
The country you asked for.
</ResponseField>

<ResponseField name="type" type="string">
The type you asked for.
</ResponseField>

<ResponseField name="price" type="object">
Pricing details.

<Expandable title="properties">

<ResponseField name="monthlyPrice" type="number">
What you pay per month for the number, in USD. Use this value.
</ResponseField>

<ResponseField name="number_type" type="string">
The number type.
</ResponseField>

<ResponseField name="current_price" type="string">
The provider's cost, before Trillet pricing. Not what you're charged.
</ResponseField>

<ResponseField name="basePrice" type="number">
`current_price` as a number. Not what you're charged.
</ResponseField>

</Expandable>
</ResponseField>

## Errors

| Status | Body | When |
| --- | --- | --- |
| `400` | `{"error": "Country, type, and workspace ID are required."}` | A parameter or `x-workspace-id` is missing |
| `403` | `{"error": "...", "code": "TOLL_FREE_NOT_AVAILABLE"}` | `type` is toll-free |
| `500` | `{"error": "Failed to retrieve phone number price"}` | The price could not be retrieved |

<ResponseExample>
```json
{
  "country": "US",
  "type": "local",
  "price": {
    "number_type": "local",
    "current_price": "0.79",
    "basePrice": 0.79,
    "monthlyPrice": 6.79
  }
}
```
</ResponseExample>


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
