---
title: "Calculate taxes"
method: POST
path: "/v4/public/tax-calculations"
tags: ["Prices"]
---

# Calculate taxes

`POST /v4/public/tax-calculations`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/public/tax-calculations`
- Auth: HTTP bearer

Helper for tax calculations

## Request body

- TaxCalculation
  - `contact` object: Address (required for public endpoint)
    - `city` string: City
    - `state` string, required: State
    - `zip` string, required: ZIP
    - `country` 'CA' | 'US': Country
  - `items` object[], required: List of items for taxation
    - `amount` integer: Amount
    - `type` 'number' | 'automated-transcription' | 'premium-music' | 'call-recording' | 'extension' | 'tax' | 'voip' | 'live-receptionist' | 'live-receptionist-plus' | 'setup-fee' | '10-dlc' | 'device' | 'shipping' | 'interstate-toll' | 'intrastate-toll' | 'lines' | 'invoice' | 'forwarding-voip': Service type
    - `code` integer: Code
    - `with_recovery_fee` boolean: Add recovery fee to taxes and fees

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)