Query all outbound email events

POST

/email-flows

Query and filter outbound email events

Relations:

sender (Person): The person who sent the email

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful operation

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/email-flows' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "distinct_count": "string",
    "distinct_on": "host_name",
    "include_total_count": true,
    "limit": 10,
    "offset": 0,
    "query": "name='\''WINPC-4291'\'' AND status IN ('\''active'\'', '\''pending'\'')",
    "sort": "name desc, id"
}'

Response Example

200 - Example 1

{
    "distinct_values": [
        {
            "count": 0,
            "value": null
        }
    ],
    "pagination": {
        "count": 0,
        "total_count": 1000
    },
    "items": [
        {
            "attachments": [
                {
                    "extension": "xlsx",
                    "kind": "unspecified",
                    "name": "Q4-Report.xlsx"
                }
            ],
            "destination_domain": "example.com",
            "destination_email": "jane.doe@example.com",
            "destination_kind": "to",
            "direction": "external_destination",
            "id": "8CA67511-744C-4D74-B26E-7281CF88712F",
            "message_id": "<abc123@mail.company.com>",
            "revocation_status": "revoked",
            "sender_email": "john.smith@company.com",
            "sender_name": "John Smith",
            "source": "unspecified",
            "subject": "Q4 Financial Report",
            "timestamp": "2021-01-01T00:00:00Z",
            "total_attachments_size": 348160
        }
    ]
}

Modified at 2026-10-20 18:32:30

Query IDE application instances.

Get an outbound email event by id