Messages

Send a message

POST /v1/messages

bash

curl -X POST https://api.deliveredsms.com/v1/messages \
  -H "Authorization: Bearer dsms_sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "+15005550100", "to": "+15005550006", "body": "Hello" }'

Parameter	Type	Notes
`from`	string	A number you own (E.164).
`to`	string	Destination number (E.164, US/Canada).
`body`	string	Up to 1600 characters.

Returns 201 with a Message object. status starts at sent (or queued) and progresses via events.

Idempotency

Pass an Idempotency-Key header to make retries safe: the same key + same payload replays the original response; the same key with a different payload returns 409 idempotency_conflict. Records are kept for 24 hours.

Retrieve a message

GET /v1/messages/{id} — the id is the msg_... from the send response.

List messages

GET /v1/messages?limit=25&cursor=...&number=+15005550100

Newest first. number filters to messages to/from one of your numbers. Responses are { "data": [...], "has_more": bool, "next_cursor": "..." }.

Statuses

queued → sent → delivered (or failed). Inbound messages have direction inbound and status received.