LogoLogo
Jump to...Create Free API Account
  • Developer Center Introduction
  • Getting Started
    • Get an API Key
    • Send a Message
    • Add a Subscriber
    • Setting up Webhooks
  • Check Delivery Status
  • API Basics
    • Request / Response Headers
    • Request Parameters
    • Rate Limits
    • Error Response Codes
  • Messaging Routes
    • 10DLC
    • Toll-Free
    • Short Code
    • iMessage
    • RCS / RBM
  • Tutorials
    • Message Sending
      • Send an SMS Message
      • Send an MMS Message
      • Send an iMessage
        • Sender Identity
        • Subscriber Opt In
        • Send iMessages
        • SMS Fallback
      • Message Templates
      • Receive and Reply to Messages
    • Manage Subscribers
      • Custom Subscriber Attributes
      • Group Subscribers
      • Bulk Create/Update Subscribers
    • Webhooks
      • Setting up your first webhook
  • Use Cases
    • Generate and validate 2FA / MFA codes via SMS
  • FAQ
  • API Reference
Powered by GitBook
LogoLogo

Resources

  • Help Center
  • Contact

Company

  • About Us
  • Privacy Policy
  • Service Agreement

Connect with Us

  • YouTube
  • Facebook
  • X (Twitter)
  • Instagram

Mobile Text Alerts © 2025

On this page

Was this helpful?

Export as PDF
  1. Messaging Routes

Short Code

Learn about dedicated short codes and how to call the API for your account's number information

PreviousToll-FreeNextiMessage

Last updated 2 months ago

Was this helpful?

What is a dedicated short code?

A dedicated short code is a 5 or 6-digit phone number for sending and receiving messages that is exclusively owned by a single brand or organization (example: 52001).

Dedicated short codes have the best throughput (rate of messages sent per second) and the most convenience for users (since they are short, easy to remember, and easy to type into a phone). Dedicated short codes allow sends of 100s or 1000s of messages at once, with high deliverability rates.

Pros for using a dedicated short code

  • Dedicated short codes have a much higher SMS throughput volume (starting as high as 350 messages per second or 21,000 messages per minute). So messages will go out faster than with 10-digit numbers.

  • Dedicated short codes are convenient for your audience because they are typically 5-6 digits.

Cons for using a dedicated short code

  • Registration is required to use a short code in any capacity.

  • Dedicated short codes are the most costly SMS marketing option, with a one-time $2,500 provisioning fee and a $600/month leasing fee (premium and vanity codes may cost more).

  • Set-up time is significantly longer than other options, as it can take anywhere from 3 weeks to 4 months to get final approval from the mobile carriers.

Short code throughput and limits

Short code numbers give you the highest throughput by far, at as much as 21,000 text messages per minute.

Unlike 10DLCs, short code numbers have no daily limits.

Summary

Dedicated short codes cost significantly more than other messaging options, so we recommend dedicated short codes as the best fit for businesses with a more robust budget who have a large number of messages to send on a regular basis.

Short Code Type Options

There are three types of dedicated short codes. You can lease each one of these or migrate your existing dedicated code through Mobile Text Alerts.

Premium short code

Premium short codes allow spelling out a brand name or a significant word using a mobile phone’s dial pad. These codes create memorable customization, but may be pricier than other options.

Examples: 827438 for “Target” or 262966 for “Amazon."

Vanity short code

Vanity short codes are numbers that you can select from a list of available codes. With this option you can choose a code that is easy for your customers to remember.

Depending on the options available, you may even be able to select a code that fits your brand without paying the full price of leasing a premium short code.

Random short code

Random short codes are short numbers that are randomly assigned.

The benefit of choosing a random short code is that you receive all the same short code features for a lower cost than a premium or vanity short code.

Get a dedicated short code for sending messages

View your Numbers with the API

Example request

curl --location 'https://api.mobile-text-alerts.com/v3/dedicated-numbers' \
  --header 'Authorization: Bearer 3068eebf-7611-5458-830e-65tf055a0b95'

Example response

{"data":
    {"rows":
        [{"name":"Main Phone Number",
        "created":"2025-01-27T15:26:48.000Z",
        "longcodeId":10721,"number":"8332298025",
        "tollFree":1,
        "isShortcode":0,
        "branded":0,
        "pending":1,
        "verified":0,
        "countryCode":"US",
        "users":{},
        "type":"Toll-Free",
        "status":"Basic",
        "deliveryRate":0,
        "tollFreeVerificationStatus":0,
        "tollFreeVerificationSubmissionDate":"2025-03-25T18:21:23.276Z"
        }],
    "page":0,"pageSize":25,"total":1
    }
} 

If you’d like to lease a dedicated short code for your business, you can .

Just as you can view , you can view your all account's numbers and data about them such as name, type, status, and more by calling the endpoint.

contact us
Your Numbers on the platform dashboard
/dedicated-numbers
10DLC vs Toll-Free vs Short Code
Three types of short code options

List Dedicated Numbers

get
Authorizations
Query parameters
Responses
200
Success
application/json
Responseall of
400
BadRequestError
application/json
401
UnauthorizedError
application/json
403
ForbiddenError
application/json
500
InternalServerError
application/json
get
GET /v3/dedicated-numbers HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer apiKey
Accept: */*
{
  "statusCode": "MTANoLinkedAccountError",
  "success": true,
  "error": "text",
  "message": "text",
  "data": {
    "rows": [
      {
        "name": "text",
        "created": "text",
        "longcodeId": 1,
        "number": "text",
        "tollFree": 1,
        "isShortcode": 1,
        "branded": 1,
        "pending": 1,
        "verified": 1,
        "countryCode": "text",
        "users": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "type": "text",
        "status": "Basic",
        "deliveryRate": 1,
        "tollFreeVerificationStatus": null,
        "tollFreeVerificationSubmissionDate": "text"
      }
    ],
    "page": 1,
    "pageSize": 1,
    "total": 1
  }
}
  • What is a dedicated short code?
  • Pros for using a dedicated short code
  • Cons for using a dedicated short code
  • Short code throughput and limits
  • Summary
  • Short Code Type Options
  • Premium short code
  • Vanity short code
  • Random short code
  • Get a dedicated short code for sending messages
  • View your Numbers with the API
  • GETList Dedicated Numbers