Get an SMS message
Retrieve one SMS message by id, with its current delivery status and reason.
GET
https://app.usenotix.dev/api/v1/sms/{id}Full access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
Retrieve one SMS message by id, with its current delivery status and reason. Needs a full access key.
| Status | Meaning |
|---|---|
queued | Charged, waiting for the provider. |
sent | Accepted by the network. |
delivered | Confirmed delivered by the provider's delivery report. |
failed | Not delivered after being sent. The charge stands. |
rejected | Refused before delivery. The charge was returned. |
Path parameters
idstringrequired
Headers
Authorizationstringrequired
Bearer followed by your API key.
Errors
404
No message with this id belongs to the team.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/sms/<id>" \
-H "Authorization: Bearer $NOTIX_API_KEY"
import { Notix } from "notix-js";
const notix = new Notix(process.env.NOTIX_API_KEY);
const { data, error } = await notix.sms.get("sms_123");
from notix import Notix
notix = Notix() # reads NOTIX_API_KEY
message, _ = notix.sms.get("sms_123")
use Notix\Notix;
$notix = new Notix(getenv('NOTIX_API_KEY'));
$message = $notix->sms->get('sms_123');
Response200
{
"id": "sms_abc123",
"to": "+234*******5678",
"status": "queued",
"segments": 1,
"network": "MTN",
"charge": {
"currency": "USD",
"amount": "8.00"
},
"reason": {
"code": "not_reachable",
"message": "Recipient number not reachable."
},
"createdAt": "2026-09-08T10:00:00.000Z",
"updatedAt": "2026-09-08T10:00:05.000Z"
}