Overview
The Legacy API is Instasent's first-generation SMS surface. It is superseded by the Transactional API, which exposes the same endpoint set plus DLR webhooks, SMPP and per-project tokens. Legacy stays online for backwards compatibility with existing integrations.
The Legacy API is the first-generation version of Instasent's SMS surface: sending, reading, HLR lookup, account balance and price profiles over REST at https://api.instasent.com/. It remains online so that existing integrations keep working unchanged.
What it covers
- Send SMS — single message (
POST /sms) or bulk batch (POST /sms/bulk). - Read SMS — collection (
GET /sms) and single-message lookup (GET /sms/{id}). - Number lookup — HLR-style checks (
POST /lookup,GET /lookup/{id}). - Account — current balance and details (
GET /organization/account). - Price profiles — per-country pricing for SMS and Lookup.
Every one of these is also available on the Transactional API under the same paths. The full list of parameters, request bodies and response shapes lives in the Legacy API Reference — identical to the Transactional reference for the overlapping endpoints.
Should I migrate?
If your integration is healthy and you are not adding new surface area, there is no pressure to move. The Legacy API will continue to deliver messages through the same carrier routes as the rest of the platform.
Migrate to Transactional when:
- You want DLR webhooks (Legacy exposes status via polling; Transactional pushes them).
- You need SMPP for carrier-grade throughput.
- You want per-project tokens (
api_sms) rather than account-wide credentials — smaller blast radius, easier rotation. - You are planning a larger feature that will touch the integration anyway — it is cheaper to do both at once.
There is no endpoint that lives only on Legacy, so the migration is always a straight swap of base-URL semantics and token scope, not a feature trade-off.