Messages

GET /Accounts/{AccountSid}/Messages.json

List texts.

Lists the account's texts, sent and received, one page at a time. An incoming text over 1600 characters arrives as consecutive Messages of ≤ 1600 characters each, never truncated. A filter value that isn't valid, or a query parameter not listed here, answers 400 with code 790005.

Parameters

Responses

Response fields

Example request

curl -X GET "https://api.dongleswithwings.com/2010-04-01/Accounts/{AccountSid}/Messages.json" \
  -u "$ACCOUNT_SID:$AUTH_TOKEN"

Example response

{
  "page": 0,
  "page_size": 50,
  "uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463/Messages.json?To=%2B61491570156&DateSent=2026-11-02&PageSize=50&Page=0",
  "first_page_uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463/Messages.json?To=%2B61491570156&DateSent=2026-11-02&PageSize=50&Page=0",
  "next_page_uri": null,
  "previous_page_uri": null,
  "messages": [
    {
      "sid": "SM2e501f7cf7d4db3bf2f2a062d558b817",
      "account_sid": "ACa61cd972830fc5bc41386edc0a9f8463",
      "to": "+61491570156",
      "from": "+61491570158",
      "body": "Can we move it to 10am instead?",
      "num_segments": "1",
      "num_media": "0",
      "error_code": null,
      "error_message": null,
      "date_created": "Mon, 02 Nov 2026 05:41:30 +0000",
      "date_sent": "Mon, 02 Nov 2026 05:41:28 +0000",
      "date_updated": "Mon, 02 Nov 2026 05:41:30 +0000",
      "price": null,
      "api_version": "2010-04-01",
      "uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463/Messages/SM2e501f7cf7d4db3bf2f2a062d558b817.json",
      "status": "received",
      "direction": "inbound"
    }
  ]
}

POST /Accounts/{AccountSid}/Messages.json

Send a text from your line.

Texts report sent, not delivered, until SMS status reports ship. No MMS, messaging services or scheduling in v1.

Sends a text from your line. The answer is 201, with status queued and num_segments (GSM-7 is 153 characters per part, UCS-2 is 67).

• Refused parameters: MessagingServiceSid, ContentSid, ContentVariables, SendAt, ScheduleType, ShortenUrls, ValidityPeriod, and any parameter not listed here (e.g. MaxPrice, Attempt) each give 400, code 710003, naming it in parameter. MediaUrl gives 711001 (no MMS in v1).
• Per-line limits: texts per hour and per day (your line's send policy). Past one of these limits the answer is 710001.
• Statuses: delivered / undelivered arrive only once SMS status reports are built. Until then, sent is the last status.

Request body

Form-encoded (application/x-www-form-urlencoded).

Any parameter not listed here is refused with 710003, naming it in parameter: v1 never ignores one.

Responses

Response fields

Example request

curl -X POST "https://api.dongleswithwings.com/2010-04-01/Accounts/{AccountSid}/Messages.json" \
  --data-urlencode "To=+61491570158" \
  --data-urlencode "From=+61491570156" \
  --data-urlencode "Body=Your appointment is tomorrow at 9:30am. Reply C to cancel." \
  --data-urlencode "StatusCallback=https://hooks.example.com/sms/status" \
  -u "$ACCOUNT_SID:$AUTH_TOKEN"

Example response

{
  "sid": "SM376a448e3788676f35200c0f74bec592",
  "account_sid": "ACa61cd972830fc5bc41386edc0a9f8463",
  "to": "+61491570158",
  "from": "+61491570156",
  "body": "Your appointment is tomorrow at 9:30am. Reply C to cancel.",
  "num_segments": "1",
  "num_media": "0",
  "error_code": null,
  "error_message": null,
  "date_created": "Mon, 02 Nov 2026 05:20:11 +0000",
  "date_sent": null,
  "date_updated": "Mon, 02 Nov 2026 05:20:11 +0000",
  "price": null,
  "api_version": "2010-04-01",
  "uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463/Messages/SM376a448e3788676f35200c0f74bec592.json",
  "status": "queued",
  "direction": "outbound-api"
}

GET /Accounts/{AccountSid}/Messages/{SMSid}.json

Read one text.

Returns one text. A Sid that isn't on this account gives 404 (code 20404).

Responses

Response fields

Example request

curl -X GET "https://api.dongleswithwings.com/2010-04-01/Accounts/{AccountSid}/Messages/{SMSid}.json" \
  -u "$ACCOUNT_SID:$AUTH_TOKEN"

Example response

{
  "sid": "SM3a823f1447314a11c6bea88be87b2b0c",
  "account_sid": "ACa61cd972830fc5bc41386edc0a9f8463",
  "to": "+61491570158",
  "from": "+61491570156",
  "body": "Sure, 10am works. See you then.",
  "num_segments": "1",
  "num_media": "0",
  "error_code": null,
  "error_message": null,
  "date_created": "Mon, 02 Nov 2026 05:41:31 +0000",
  "date_sent": "Mon, 02 Nov 2026 05:41:34 +0000",
  "date_updated": "Mon, 02 Nov 2026 05:41:34 +0000",
  "price": null,
  "api_version": "2010-04-01",
  "uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463/Messages/SM3a823f1447314a11c6bea88be87b2b0c.json",
  "status": "sent",
  "direction": "outbound-reply"
}

POST /Accounts/{AccountSid}/Messages/{SMSid}.json

Redact a text (Body="").

Redacts the text's body (privacy). The only update is Body="". Any other Body answers 710004, and any other parameter answers 710003. Records are kept for 3 months (90 days), then deleted with their bodies, and never backed up beyond that.

Request body

Form-encoded (application/x-www-form-urlencoded).

Any parameter not listed here is refused with 710003, naming it in parameter: v1 never ignores one.

Responses

Response fields

Example request

curl -X POST "https://api.dongleswithwings.com/2010-04-01/Accounts/{AccountSid}/Messages/{SMSid}.json" \
  --data-urlencode "Body=" \
  -u "$ACCOUNT_SID:$AUTH_TOKEN"

Example response

{
  "sid": "SMa6b1a15fa6aac00bb3439addd9a53b87",
  "account_sid": "ACa61cd972830fc5bc41386edc0a9f8463",
  "to": "+61491570156",
  "from": "+61491570158",
  "body": "",
  "num_segments": "1",
  "num_media": "0",
  "error_code": null,
  "error_message": null,
  "date_created": "Sun, 01 Nov 2026 22:15:40 +0000",
  "date_sent": "Sun, 01 Nov 2026 22:15:38 +0000",
  "date_updated": "Mon, 02 Nov 2026 06:30:00 +0000",
  "price": null,
  "api_version": "2010-04-01",
  "uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463/Messages/SMa6b1a15fa6aac00bb3439addd9a53b87.json",
  "status": "received",
  "direction": "inbound"
}

DELETE /Accounts/{AccountSid}/Messages/{SMSid}.json

Delete a text's record.

Deletes the text's record (privacy).

Responses

Example request

curl -X DELETE "https://api.dongleswithwings.com/2010-04-01/Accounts/{AccountSid}/Messages/{SMSid}.json" \
  -u "$ACCOUNT_SID:$AUTH_TOKEN"

Example response

HTTP/1.1 204 No Content (empty body)