# Numbers and registration (/docs/sms/senders)

Live messages go from your organization's own phone numbers, and US carriers only deliver
application-to-person (A2P) SMS from numbers registered with them. coss.com buys the numbers and
submits the registrations for you, through its SMS provider (Twilio): owners and admins do both
on the dashboard's organization **SMS** page. Sandbox environments need neither: their messages
are [simulated](/docs/sms/testing).

Numbers belong to the organization, so every environment's keys can send from them. Live SMS
needs a paid plan, which also sets how many numbers you can hold (see the [plans](/docs/billing)).

## Numbers [#numbers]

| Kind      | Countries | Sends to                                        | Needs                     |
| --------- | --------- | ----------------------------------------------- | ------------------------- |
| Local     | US, CA    | The countries your organization allows          | US A2P 10DLC registration |
| Toll-free | US, CA    | The US and Canada only                          | Toll-free verification    |

Search by area code (local) or for any toll-free number and buy one. A number is billed monthly,
from the day you buy it until you release it ([pricing](/docs/sms/countries-and-pricing)).
Releasing one stops it sending at once; messages still waiting for it fail with
`sender_unavailable`. Deleting your organization releases all of its numbers.

To move a number to another provider, [contact support](/docs/support) first: a port needs the
number to stay active until it completes, so a released number can't be moved. The registration
doesn't move with it, so the new provider registers the number again.

Each number has a **receiving environment**: the live environment its replies go to
([receiving](/docs/sms/receiving)). Without one, replies are dropped, though STOP and START still
apply.

```ts twoslash
import { Coss } from "coss";
const coss = new Coss();
// ---cut---
const { data: numbers } = await coss.sms.numbers.list();
const ready = numbers?.data.filter((number) => number.can_send);
// e.g. [{ phone_number: "+14155550123", kind: "local", registration_status: "approved", … }]
```

`coss.sms.numbers.list()` returns every number of the organization with its
`registration_status` (`draft`, `submitted`, `in_review`, `approved`, `rejected` or `failed`),
`can_send` (live messages can go from it now) and `receives_here` (its replies arrive in the
environment of the key you call with).

## US A2P 10DLC (local numbers) [#us-a2p-10dlc-local-numbers]

An organization has one 10DLC registration, and every local number it holds, bought before or
after, sends under it once it is approved. You fill in one form; coss.com then submits, in order:

1. **Your business profile**: legal name, company type, tax ID (EIN for US companies), industry,
   website, address and an authorized contact (name, title, email and phone number). Public
   companies add their stock exchange and ticker.
2. **The brand**, your business as carriers know it. Choose:
   - **Low-volume standard**, for fewer than 6,000 segments a day. No secondary vetting, and a lower
     monthly campaign fee; its campaign's use case is always low-volume mixed.
   - **Standard**, for higher volumes. It adds secondary vetting, which sets its throughput with
     the carriers.
3. **The campaign**: what you send and to whom. Pick a use case (one-time codes, account
   notifications, customer care, delivery notifications, fraud alerts, marketing, mixed or low
   volume mixed), describe the messages and how people opt in, give two to five sample messages,
   and say whether they contain links or phone numbers.

Each step waits for its review before the next one is submitted; together they usually take a few
days. The dashboard shows each
registration's status, and the reason when one is rejected: fix it and submit again.

Carriers reject campaigns most often because the opt-in isn't clear. Describe exactly where people
give you their number and agree to messages (a sign-up form with an unchecked consent box, a
keyword they text you), make sure your website shows the same, and write samples that match the
use case and name your business.

## Toll-free verification [#toll-free-verification]

A toll-free number is verified on its own: buy it, then submit the same business profile and a
campaign for it, with a public URL that shows where people opt in and your privacy policy's URL.
Reviewers expect the policy to say you never share phone numbers or text message consent with third
parties for marketing. Verification usually takes a few days. Toll-free numbers can't send outside
the US and Canada.

A rejected verification shows its reason on the SMS page. **Fix and resubmit** opens the form with
your answers filled in; the number keeps its verification, which Twilio reviews again.

## Fees [#fees]

Numbers and US carrier fees are passed through at cost, on your coss.com invoice:

- **Numbers**: monthly, from the day you buy one.
- **Brand registration**: once, when the brand is submitted; standard brands add the secondary
  vetting fee.
- **Campaign vetting**: once, when the campaign is submitted.
- **Campaign**: monthly from its approval (lower for low-volume standard brands).

Registration fees are charged when a step is submitted, whether or not carriers approve it.
Toll-free verification has no fee. Current prices:

| Product | Rate | |
| --- | --- | --- |
| SMS (US) | $0.0142 per segment | |
| SMS (other countries) | $0.022 to $0.1134 per segment | By country: coss.com/pricing#sms |
| SMS received (US) | $0.016 per segment | |
| SMS received (other countries) | $0.0104 to $0.0104 per segment | By country: coss.com/pricing#sms |
| SMS phone numbers (local) | $1.15 per number-month | |
| SMS phone numbers (toll-free) | $2.15 per number-month | |
| SMS registration fees (brand registration) | $4.50 | Passed through at cost |
| SMS registration fees (brand vetting) | $41.50 | Passed through at cost |
| SMS registration fees (campaign vetting) | $15.00 | Passed through at cost |
| SMS registration fees (campaign, monthly) | $10.00 | Passed through at cost |
| SMS registration fees (low-volume campaign, monthly) | $1.50 | Passed through at cost |
