NAME¶

twils — List Twilio SMS message resources

SYNOPSIS¶

DESCRIPTION¶

twils retrieves Message resources from the Twilio REST API and prints their message SID's to standard output.

Messages are returned in reverse chronological order.

In the second form, the SID of one specific message is given.

OPTIONS¶

-c

Specify the configuration file.

This file is simply a shell script that when sourced must define the ACCOUNT_SID and AUTH_TOKEN shell variables containing the corresponding Twilio credentials.

If the -c flag is not specified, /etc/twilio.conf is assumed.

-C

Pass curlflag to curl(1).

--from

Restrict to messages sent from the specified phone number (must be in E.164 format) or 5 or 6 digit short code.

--to

Restrict to messages sent to the specified phone number (must be in E.164 format) or 5 or 6 digit short code.

--minDate

Restrict to messages sent on or after the specified date, which must be in the form YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ.

--maxDate

Restrict to messages sent on or before the specified date, which must be in the form YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ.

--limit

Return at most num results.

-p

Specify authentication token, overriding AUTH_TOKEN from the configuration file, if any.

-P

Read authentication token from the terminal.

--pageSize

Specify the query page size. Default is 1000.

--raw

Output the raw XML from each page of results, instead of just the message SID's.

-u

Specify Account SID, overriding ACCOUNT_SID from the configuration file, if any.

EXIT STATUS¶

twils exits zero normally, or 1 if an error occurs.

Errors returned from the Twilio REST API are reported to standard error.

SEE ALSO¶

curl(1), smslen(1), twirm(1), twiping(1), twilog(1).

AUTHOR¶

Archie L. Cobbs ⟨archie.cobbs@gmail.com⟩