---
title: "Preview prorated rental cost for renting a phone number today"
method: GET
path: "/product/proration-amount"
tags: ["Phone Numbers"]
---

# Preview prorated rental cost for renting a phone number today

`GET /product/proration-amount`

Returns the immediate prorated charge for renting one phone number from today through the end of the current billing cycle, plus the recurring monthly rate. Use this to show a "you'll be charged $X today" preview before calling [`POST /product/rent-number`](#operation/rentPhoneNumber).

Returns `400` if the organization doesn't have the phone-numbers feature configured (contact support) or if the org is currently locked (e.g. unpaid invoices — call [`GET /product/unpaid-invoices`](#operation/getUnpaidInvoices) first to check).

## Response `200`

Successful response

- object
  - `status` boolean
  - `data` object
    - `immediateCharge` number, float — Amount that will be charged today (USD).
    - `perNumberRecurringAmount` number, float — Monthly per-number recurring charge after the prorated first period (USD).
    - `monthlyRate` number, float
    - `prorationAmount` number, float
    - `daysRemaining` integer
    - `daysInMonth` integer
    - `proratedValue` number, float — Fraction of the month remaining (`daysRemaining / daysInMonth`).

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)