---
title: "Phone number price and balance"
method: GET
path: "/api/v1/people/phones/pricing"
tags: ["People"]
---

# Phone number price and balance

`GET /api/v1/people/phones/pricing`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/people/phones/pricing`
- Auth: HTTP bearer

Check the price of a phone number, whether your plan includes phone numbers, and your credit balance before you spend anything. Free.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:unlock_contacts` |

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `price_per_phone` integer
  - `charged_only_when_found` boolean
  - `already_unlocked_free` boolean
  - `plan_includes_phones` boolean
  - `billing_exempt` boolean
  - `credits_available` integer
  - `summary` string

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:unlock_contacts.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)