Preview prorated rental cost for renting a phone number today

GET

https://api.smallest.ai/atoms/v1/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.

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 first to check).

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).

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Response

Successful response

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	import requests
2
3	url = "https://api.smallest.ai/atoms/v1/product/proration-amount"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"status": true,
3	"data": {
4	"immediateCharge": 5.3,
5	"perNumberRecurringAmount": 10,
6	"monthlyRate": 10,
7	"prorationAmount": 5.3,
8	"daysRemaining": 16,
9	"daysInMonth": 30,
10	"proratedValue": 0.53
11	}
12	}