---
title: "Get number price"
method: GET
path: "/v2/api/partner/accounts/{id}/numbers/price"
tags: ["Partner"]
---

# Get number price

`GET /v2/api/partner/accounts/{id}/numbers/price`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/partner/accounts/{id}/numbers/price`
- Auth: API key in header `Authorization`

Returns what adding one more number to the account costs today. When the account already pays for a free number slot, `included` is `true` and `amount_due_now` is `0`. Otherwise `amount_due_now` is the charge for the rest of the account's current billing period, net of the subscription's discount, tax included. Requires the `PARTNER` scope.

## Path parameters

- `id` string, required

## Response `200`

Price of one more number

- object
  - `data` object
    - `included` boolean: `true` when the account already pays for a number slot that no number uses: the next number costs nothing.
    - `unit_amount_before_discount` integer: The price of one number for a full billing period, before discount, in the smallest currency unit.
    - `amount_due_now` integer: What Allo charges when you add the number: prorated to the end of the current period, net of the subscription's discount, tax included. `0` when `included` is `true`.
    - `currency` string: Lowercase ISO 4217 code of the account's subscription.
    - `interval` 'MONTHLY' | 'YEARLY': Billing interval of the account's subscription.

## Other responses

- `401`: Invalid or missing API key
- `402`: The account has no subscription Allo can bill (PARTNER_SUBSCRIPTION_NOT_BILLABLE).
- `403`: The API key lacks the PARTNER scope.
- `404`: No account with this id was provisioned by your API key, or the account is deactivated (PARTNER_ACCOUNT_NOT_FOUND).
- `429`: Rate limit exceeded
- `500`: Billing is temporarily unavailable (PARTNER_BILLING_UNAVAILABLE). Retry in a few seconds.

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/partner/accounts/:id/numbers/price/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)