Return stored logs for an account

GET 
/v1/logs/:account

Output is a downloadable text file with one JSON log entry per line, or a plain-text notice when nothing is stored

Nothing is stored unless logging is enabled for the account, either with the account logs flag or the global logs.all setting. IMAP accounts record the protocol trace, Gmail API and MS Graph accounts record their API requests, and SMTP transactions are recorded for any account that sends over SMTP.

Request

Responses

200

Returns the account log as a plain text stream.

400

Invalid input - the path parameters, query arguments, or request payload did not pass validation. Also returned when the email server refused the request, in which case the response carries a code and the server response instead of a field list

401

Authentication failed - the access token is missing, invalid, or was not accepted

403

Access denied - the access token does not grant permission for this operation (token scope, account, or IP address restriction)

404

Not found - the requested entity (account, message, mailbox, etc.) does not exist

429

Rate limit exceeded - too many requests were made with this access token

500

Internal server error - an unexpected error occurred while processing the request