> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quote a Calling Number

> Get the current price and consent version for one monthly Voice number.

Returns the current `number_month` quote for quantity `1`. Requires `voice_calls.write`, the **Voice Calls** product entitlement, and an API key created by a current account owner. Send an empty JSON object; the endpoint accepts no body fields.

Review `amount`, `recurringPolicy`, `initialPeriod`, and `nextChargeAt` before obtaining purchase consent. A quote with `status: "unrated"` cannot authorize a purchase. Send the returned `quoteId` and `consentVersion` when [acquiring the number](https://docs.tracklysms.com/api-reference/voice/numbers/acquire-calling-number.md). The service rechecks the quote during purchase.

## Response Fields

**status** `string`

`priced` or `unrated`.

**code** `string | null`

The reason when the quote is unrated.

**quoteId** `string`

The price identity to use for purchase consent.

**sku** `string`

Always `number_month`.

**quantity** `string`

Always `1`.

**amount** `string | null`

Quoted USD amount when priced.

**consentVersion** `string`

Current paid-feature consent version.

**recurringPolicy** `string | null`

The billing period policy from accepted Voice terms.

## Example

```bash cURL theme={null}
curl -X POST https://api.tracklysms.com/api/v1/voice/calling-numbers/quote \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Error Codes

| Status | Code | Meaning |
| - | - | - |
| 403 | `owner_required` | The key's creator is not a current account owner. |
| 422 | `json_required`, `invalid_request`, `invalid_fields`, `invalid_quote` | Send a valid empty JSON object; `invalid_quote` means the number quote is unavailable. |
| 429 | `rate_limited` | The account or key creator reached the quote request limit. |
| 503 | `rate_limit_unavailable` | Request admission is temporarily unavailable. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.