---
title: "SMS test numbers"
description: "The numbers a template's test text may go to besides the simulator. Adding and verifying one happens in the dashboard (a code is texted to the phone)."
url: https://www.unitpost.com/docs/api/sms-test-numbers
section: API reference
updated: 2026-10-13
---
# SMS test numbers

## SMS test numbers

> The numbers a template's test text may go to besides the simulator. Adding and verifying one happens in the dashboard (a code is texted to the phone).

Full schemas: [OpenAPI 3.1](https://www.unitpost.com/api/v1/openapi.json). HTML reference: https://www.unitpost.com/docs/sms#sms-test-numbers.

## Operations

### `GET /api/v1/sms/test-destinations`

List SMS test numbers

The numbers your workspace may text a template's test to besides the simulator: `pending` until the code texted to it is entered, then `verified`. Adding and verifying one happens in the dashboard (Phone numbers → Testing): it proves the phone is the person's. Requires the `sms:read` capability.

Reference: https://www.unitpost.com/docs/sms/get-sms-test-destinations ([Markdown](https://www.unitpost.com/docs/sms/get-sms-test-destinations.md))

### `DELETE /api/v1/sms/test-destinations/{id}`

Remove an SMS test number

Remove a test number; template tests can no longer text it. Requires the `sms:manage` capability.

Reference: https://www.unitpost.com/docs/sms/delete-sms-test-destinations-id ([Markdown](https://www.unitpost.com/docs/sms/delete-sms-test-destinations-id.md))

## Related

- [SMS registrations](https://www.unitpost.com/docs/api/sms-registrations): Carrier registrations and their review state. Submitting a 10DLC one is an SMS quote, then its confirm.
- [SMS billing](https://www.unitpost.com/docs/api/sms-billing): What your workspace pays for SMS every month. Buying a carrier resource is an SMS quote, then its confirm.
- [SMS quotes](https://www.unitpost.com/docs/api/sms-quotes): Buy carrier resources by API: quote (`sms:manage`, nothing charged), show the person the price, then confirm with the quote's single-use token and an `Idempotency-Key` (`sms:purchase`, which no key preset includes). API purchases count against a monthly cap the workspace owner sets in the dashboard; with none set they are refused. A toll-free number, releasing a number and identity documents stay in the dashboard.