Skip to main content
The Log Search API gives you programmatic access to email delivery logs, sender profiles, and alerts. You can also request sender delisting through the remediation endpoint. Use it to investigate delivery issues, monitor sender activity, and build these capabilities into your own control panel or support tools.

​
Base URL

Use https://api.mailchannels.net/outbound/v1 as the base URL for all API requests. All requests must use HTTPS.

​
Authentication

Include your Outbound Filtering API key in the X-API-KEY header with every request.

​
Rate limits

The API allows up to 100 queries per second per customer. Queries that exceed this limit may receive a 503 Service Temporarily Unavailable response.

​
Pagination

POST /search returns 20 results by default. Use the count query parameter to request up to 100 results per page. Use start_at to set the offset, starting at 0. To fetch the next page, increase start_at by count. The API rejects requests with a 400 Bad Request response if start_at + count exceeds 9,999. To retrieve more results, split your search into smaller date ranges using start_date and end_date, and paginate through each range.

​
Time range

By default, POST /search searches the last 3 days of data. To search a different date range, include both start_date and end_date in the request body, using the YYYY-MM-DD format.