Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time.
Use the search for outreach emails endpoint to find emails that your team has created and sent as part of Apollo sequences.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "apollo-rest-api",
"summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.",
"description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).",
"termsOfService": "https://www.apollo.io/terms/api",
"contact": {
"name": "Apollo API Support",
"url": "https://docs.apollo.io/"
},
"version": "1.0"
},
"servers": [
{
"url": "https://api.apollo.io/api/v1"
}
],
"tags": [
{
"name": "Sequences",
"description": "Manage outreach sequences and the contacts enrolled in them."
}
],
"components": {
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "header",
"name": "x-api-key",
"description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)."
},
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)."
}
},
"schemas": {
"ErrorDetails": {
"type": "object",
"description": "Machine-readable detail for an error that uses the new format, returned alongside the endpoint's existing error fields. The legacy error fields at the root level (`error`, `error_code`, `message`, etc) are removed on 2027-02-16, after which `error_details` is the only error payload. Some errors already return `error_details` on its own.",
"properties": {
"code": {
"type": "string",
"description": "Stable identifier in the form `DOMAIN.CATEGORY.REASON`. Branch on this value; the human-readable `message` can change.",
"example": "AUTH.AUTHENTICATION.CREDENTIALS_MISSING"
},
"message": {
"type": "string",
"description": "Human-readable explanation of what went wrong.",
"example": "This request carried no credential Apollo could authenticate."
},
"suggestions": {
"type": "array",
"description": "Ordered, actionable next steps. Each entry carries a `label`, and where relevant the `parameter`, `header`, or `url` it refers to.",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"example": "Send your API key in the X-Api-Key header"
},
"url": {
"type": "string",
"example": "https://docs.apollo.io/reference/authentication"
},
"parameter": {
"type": "string",
"example": "webhook_url"
},
"parameters": {
"type": "array",
"description": "Several parameters, any one of which satisfies the requirement.",
"items": {
"type": "string"
},
"example": [
"name",
"domain",
"website_url",
"linkedin_url"
]
},
"header": {
"type": "string",
"example": "X-Api-Key"
},
"example": {
"type": "string",
"description": "A valid sample value for the parameter named above."
},
"retry_after_seconds": {
"type": "integer",
"description": "On a rate-limit refusal, how long to wait before retrying.",
"example": 60
}
}
}
},
"context": {
"type": "object",
"description": "Values from your request that explain the refusal. Each entry is an object rather than a bare value, so read `context..value`. Absent when the error needs no context.",
"additionalProperties": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"description": {
"type": "string"
}
}
},
"example": {
"window": {
"value": "hourly",
"description": "The rate-limit window your request exceeded"
}
}
}
}
}
}
},
"security": [
{
"apiKey": []
},
{
"bearerAuth": []
}
],
"paths": {
"/emailer_messages/search": {
"get": {
"summary": "Search for outreach emails",
"description": "## Endpoint essentials\n\n**API key access:** `api/v1/emailer_messages/search` or `Master API key`\n\n**OAuth scopes:** `emailer_messages_search`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nSequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time.
Use the search for outreach emails endpoint to find emails that your team has created and sent as part of Apollo sequences.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.",
"tags": [
"Sequences"
],
"operationId": "emailer_messages/search",
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"examples": {
"OK": {
"summary": "OK",
"value": "{\n \"breadcrumbs\": [],\n \"emailer_messages\": [\n {\n \"id\": \"684b2203a2ce950021cbf730\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"status\": \"failed\",\n \"time_zone\": \"America/Los_Angeles\",\n \"provider_message_id\": null,\n \"to_name\": \"Gina Larkin\",\n \"due_at\": \"2025-06-12T18:57:08.553+00:00\",\n \"completed_at\": null,\n \"emailer_touch_id\": \"684b216ec95a4f001d968d1b\",\n \"emailer_campaign_id\": \"684b215edf80730019db612c\",\n \"emailer_step_id\": \"684b216ec95a4f001d968d19\",\n \"failed_at\": \"2025-06-12T19:04:06.820+00:00\",\n \"failure_reason\": \"Account stage is Active Opportunity. Change stage for account or adjust settings under Sequence => Settings and retry.\",\n \"attachment_ids\": [],\n \"enable_tracking\": true,\n \"type\": \"outreach_automatic_email\",\n \"contact_id\": \"66ad20ab23d5d40001c8d07d\",\n \"provider_thread_id\": null,\n \"schedule_delayed_reason\": null,\n \"demoed\": null,\n \"email_account_id\": \"6633baaece5fbd01c791d7ca\",\n \"due_at_manually_changed\": true,\n \"not_sent_reason\": \"account_stage_safeguard\",\n \"bounce\": null,\n \"spam_blocked\": null,\n \"tracking_disabled_reason\": null,\n \"created_at\": \"2025-06-12T18:52:51.021Z\",\n \"async_sending\": true,\n \"due_at_source\": \"Email was sent using Send Now action\",\n \"crm_id\": null,\n \"replied\": null,\n \"needs_dynamic_assemble\": true,\n \"personalized_opener\": null,\n \"reply_class\": null,\n \"schedule_delayed_limit_reason\": null,\n \"schedule_delayed_reason_details\": null,\n \"sensitive_info_redacted\": null,\n \"account_id\": \"6518c6184f20350001a0b9c0\",\n \"recipients\": [\n {\n \"email\": \"gina.larkin@apollo.io\",\n \"raw_name\": \"Gina Larkin\",\n \"recipient_type_cd\": \"to\",\n \"contact_id\": \"66ad20ab23d5d40001c8d07d\",\n \"user_id\": null\n }\n ],\n \"send_from\": {\n \"email\": \"test.marcus.hale@apollomail.io\",\n \"raw_name\": \"David Smith\",\n \"recipient_type_cd\": null,\n \"contact_id\": null,\n \"user_id\": null\n },\n \"from_email\": \"test.marcus.hale@apollomail.io\",\n \"to_email\": \"gina.larkin@apollo.io\",\n \"from_name\": \"David Smith\",\n \"bcc_emails\": [],\n \"cc_emails\": [],\n \"send_from_info\": \"6633baaece5fbd01c791d7ca***test.marcus.hale@apollomail.io\",\n \"body_text\": \"Check out my email now!David SmithApollo Knowledge Base \",\n \"body_html\": \"
\",\n \"body_html_loaded\": true,\n \"appendment_html\": \"\",\n \"appendment_html_loaded\": true,\n \"subject\": \"Stats for you\",\n \"campaign_name\": \"Stats Sequences DO NOT USE\",\n \"campaign_max_emails_per_day\": null,\n \"campaign_position\": 1,\n \"step_max_emails_per_day\": null\n }\n ],\n \"emailer_steps\": [\n {\n \"id\": \"684b216ec95a4f001d968d19\",\n \"emailer_campaign_id\": \"684b215edf80730019db612c\",\n \"wait_time\": 0,\n \"wait_mode\": \"minute\",\n \"max_emails_per_day\": null,\n \"exact_datetime\": null,\n \"auto_skip_in_x_days\": null,\n \"position\": 1\n },\n {\n \"id\": \"684886e2e7c9bd0011e0b239\",\n \"emailer_campaign_id\": \"6848868536ec86001d300ce6\",\n \"wait_time\": 30,\n \"wait_mode\": \"minute\",\n \"max_emails_per_day\": null,\n \"exact_datetime\": null,\n \"auto_skip_in_x_days\": null,\n \"position\": 1\n },\n {\n \"id\": \"67bde6d5b5eeec0021ad09c4\",\n \"emailer_campaign_id\": \"67bde6d5b5eeec0021ad09c2\",\n \"wait_time\": 20,\n \"wait_mode\": \"day\",\n \"max_emails_per_day\": null,\n \"exact_datetime\": null,\n \"auto_skip_in_x_days\": null,\n \"position\": 1\n }\n ],\n \"num_fetch_result\": null\n}"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"text/plain": {
"examples": {
"Check API Key": {
"value": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"summary": "Check API Key"
}
}
}
}
},
"422": {
"description": "422",
"content": {
"application/json": {
"examples": {
"Page limit exceeded": {
"value": "{\n \"error\": \"Invalid parameter passed in. Page * per page number is over threshold.\"\n}"
},
"Per page cannot be 0": {
"value": "{\n \"error\": \"An error occurred. Per page cannot be 0.\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"error_details": {
"$ref": "#/components/schemas/ErrorDetails"
},
"error": {
"deprecated": true,
"description": "Legacy error field. Removed on 2027-02-16, after which `error_details` is the only error payload.",
"type": "string"
}
}
}
}
}
},
"429": {
"description": "429",
"content": {
"application/json": {
"examples": {
"Too many requests": {
"value": "{\n \"message\": \"The maximum number of api calls allowed for api/v1/emailer_messages/search is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\",\n \"error_details\": {\n \"code\": \"USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED\",\n \"message\": \"You have made more API requests than your plan allows in this time window.\",\n \"suggestions\": [\n {\n \"label\": \"Wait until the rate limit resets, then retry the API request.\"\n },\n {\n \"label\": \"Check the Apollo Docs to understand API rate limits and how to use response headers to prevent rate-limit errors.\",\n \"url\": \"https://docs.apollo.io/reference/rate-limits\"\n }\n ],\n \"context\": {\n \"window\": {\n \"value\": \"hour\",\n \"description\": \"The rate limit window that was exhausted, such as \\\"minute\\\" or \\\"hour\\\"\"\n }\n }\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"error_details": {
"$ref": "#/components/schemas/ErrorDetails"
},
"message": {
"deprecated": true,
"description": "Legacy error field. Removed on 2027-02-16, after which `error_details` is the only error payload.",
"type": "string",
"example": "The maximum number of api calls allowed for api/v1/emailer_messages/search is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade."
}
}
}
}
}
}
},
"parameters": [
{
"name": "emailer_message_stats[]",
"in": "query",
"required": false,
"description": "Find emails based on their current status, such as whether they were delivered or opened. You can add multiple statuses.
Possible values include:
`delivered`
`scheduled`
`drafted`
`not_opened`
`opened`
`clicked`
`unsubscribed`
`demoed`
`bounced`
`spam_blocked`
`failed_other`
",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "emailer_message_reply_classes[]",
"in": "query",
"required": false,
"description": "Find emails based on the response sentiment of the recipient. This can include the recipient expressing interest in meeting or having a follow-up question. You can add multiple values.
Possible values include:
`willing_to_meet`
`follow_up_question`
`person_referral`
`out_of_office`
`already_left_company_or_not_right_person`
`not_interested`
`unsubscribe`
`none_of_the_above`
",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "user_ids[]",
"in": "query",
"required": false,
"description": "Find emails sent by specific users in your team's Apollo account. You can add multiple users.
Example: `66302798d03b9601c7934ebf`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "email_account_id_and_aliases",
"in": "query",
"required": false,
"description": "",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "emailer_campaign_ids[]",
"in": "query",
"required": false,
"description": "Search for emails that are included in specific sequences in your Apollo account. You can search multiple sequences. Any sequence not included in this parameter will be exclude from search results.
Example: `66e9e215ece19801b219997f`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "not_emailer_campaign_ids[]",
"in": "query",
"required": false,
"description": "Exclude emails from specific sequences in your Apollo account. You can exclude multiple sequences. Any sequence not excluded using this parameter will be included in search results.
Example: `66e9e215ece19801b219997f`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "emailer_message_date_range_mode",
"in": "query",
"required": false,
"description": "Use this parameter in combination with the `emailer_message_date_range[max]` and `emailer_message_date_range[min]` parameters. Find emails based on 1 of the following options:
`due_at`: When emails are scheduled to be delivered.
`completed_at`: When emails were delivered.
",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "emailer_message_date_range[max]",
"in": "query",
"required": false,
"description": "Set the upper bound of the date range you want to search.
Use this parameter in combination with the `emailer_message_date_range[min]` and `emailer_message_date_range_mode` parameters. This date should fall after the `emailer_message_date_range[min]` date.
The date should be formatted as `YYYY-MM-DD`.
Example: `2025-10-30`",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "emailer_message_date_range[min]",
"in": "query",
"required": false,
"description": "Set the lower bound of the date range you want to search.
Use this parameter in combination with the `emailer_message_date_range[max]` and `emailer_message_date_range_mode` parameters. This date should fall before the `emailer_message_date_range[max]` date.
The date should be formatted as `YYYY-MM-DD`.
Example: `2025-10-30`",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "not_sent_reason_cds[]",
"in": "query",
"required": false,
"description": "Find emails based on the reason they were not sent. You can add multiple values.
Possible values include:
`contact_stage_safeguard`
`same_account_reply`
`account_stage_safeguard`
`email_unverified`
`snippets_missing`
`personalized_opener_missing`
`thread_reply_original_email_missing`
`no_active_email_account`
`email_format_invalid`
`ownership_permission`
`email_service_provider_delivery_failure`
`sendgrid_dropped_email`
`mailgun_dropped_email`
`gdpr_compliance`
`not_valid_hard_bounce_detected`
`other_safeguard`
`new_job_change_detected`
`email_on_global_bounce_list`
",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "q_keywords",
"in": "query",
"required": false,
"description": "Add keywords to narrow the search of the emails in your team's Apollo account.
Keywords should directly match at least part of an email's content. For example, searching the keyword `James` might return emails that were sent by `James Smith`.
Example: `Jane`",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "page",
"in": "query",
"description": "The page number of the Apollo data that you want to retrieve.
Use this parameter in combination with the `per_page` parameter to make search results for navigable and improve the performance of the endpoint.
Example: `4`",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "per_page",
"in": "query",
"description": "The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance.
Use the `page` parameter to search the different pages of data.