Fetch exported files

Purpose

This API lists all the exported files in an account.

Request URL

Method : GET

https://api.zeptomail.com/v1.1/{{export_type}}/exports

 

OAuth scope

The steps to generate and use OAuth token can be found here.

scope=Zeptomail.Exports.All

or

scope=Zeptomail.Exports.READ

 

ALL -This gives full CRUD (Create, Read, Update and Delete) access to all export APIs.

READ - This allows access only to perform READ operations.

 

Path parameters

Parameter nameValueDescription
export_type*Value: mail-logs or activity-logs or suppression-listType of export information to be obtained.

Note:

* - Mandatory parameter

Sample request

Copiedcurl "https://api.zeptomail.com/v1.1/{{export_type}}/exports"
-X GET
-H "Authorization : Zoho-oauthtoken ***"\
-H "Content-Type : application/json" \

Sample response

Copied{
    "data": [
        {
            "created_time": "11 Feb 2026 11:46 AM",
            "export_type": "mail-logs",
            "modified_time": "11 Feb 2026 11:46 AM",
            "is_content_included": false,
            "file_status": "completed",
            "file_name": "MailReport - 11 Feb 2026 11:46 AM.zip",
            "is_downloaded": false,
            "export_id": "38747230-0711-11f1-9ca1-5254003efefb",
            "search_query": {
                "mailagent_name": "All Agents",
                "is_delivered": true,
                "date_to": "11 Feb 2026 11:46 AM",
                "date_from": "27 Jan 2026 11:46 AM"
            },
            "expiry_time": "14 Feb 2026 11:46 AM",
            "created_by": "Rebecca",
            "file_size": 3952
        },
     
    ],
    "status": "success"
}