All CLI command output is sent to stdout, and can be customized in terms of output values as well as format.
By default, any output is formatted in a human-readable, columnar format like so:
_10$ twilio phone-numbers:list_10SID Phone Number Friendly Name_10PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +1209242XXXX SIP testing_10PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +1646887XXXX Congress hotline_10PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +1209337XXXX DAVID'S SECRET CRUSH
Many list commands will allow you to specify a --properties option defining which columns you'd like to display. For example, to display only the Phone Number and SMS URL columns, you would pass --properties "phoneNumber, smsUrl".
_10$ twilio phone-numbers:list --properties 'phoneNumber, smsUrl'_10Phone Number SMS URL_10+1209242XXXX https://very-secret.ngrok.io/sms_10+1646887XXXX https://handler.twilio.com/twiml/EHxxxx_10+1209337XXXX
Column names must match the camelCased JSON property names in the Twilio API for the resource. For example, you can find the possible column values for phone numbers by looking at the Incoming Phone Number API Reference
The default list of properties varies by command, and is subject to change with each release.
Append the -o json flag to a command to change the output format to JSON. When you choose JSON, the command will send the entire API response to stdout as JSON.
You can then pipe this output to tools like jq to parse the JSON as necessary.
For example:
_23# Fetch all incoming phone numbers as json, and display as an array_23# that only contains each sid and phone number._23$ twilio phone-numbers:list -o json \_23 | jq '.[] | {sid, phoneNumber, smsUrl, voiceUrl}'_23_23{_23 "sid": "PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",_23 "phoneNumber": "+1209242XXXX",_23 "smsUrl": "https://very-secret.ngrok.io/sms",_23 "voiceUrl": "https://very-secret.ngrok.io/answer"_23}_23{_23 "sid": "PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",_23 "phoneNumber": "+1646887XXXX",_23 "smsUrl": "https://handler.twilio.com/twiml/EHxxxx",_23 "voiceUrl": "https://demo.twilio.com/welcome/voice/"_23}_23{_23 "sid": "PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",_23 "phoneNumber": "+1209337XXXX",_23 "smsUrl": "",_23 "voiceUrl": ""_23}
The --properties flag does not modify command output when combined with -o json.
For example, twilio phone-numbers:list -o json --properties sid | jq . will return the entire, unmodified JSON response, not an array of objects containing sid.
To change the output format to tab separated values (TSV), add -o tsv to a command.
This format is useful for loading information into spreadsheets, or for other machine processing. Like the default, columnar output format, you can use the --properties option to specify which columns you would like included.
_10$ twilio phone-numbers:list -o tsv_10sid phoneNumber friendlyName_10PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +1209242XXXX SIP testing_10PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +1646887XXXX Congress hotline_10PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +1209337XXXX DAVID'S SECRET CRUSH