Search for Outreach Emails

Search individual outreach emails already sent or scheduled from this workspace.

GET https://api.aisa.one/apis/v1/apollo/emailer_messages/search

Search for Outreach Emails

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/apollo/emailer_messages/search \
  --header 'Authorization: Bearer <token>'

200

{
  "emailer_messages": [
    "<string>"
  ],
  "pagination": {}
}

Search individual outreach emails already sent or scheduled from this workspace. Returns emailer_messages alongside emailer_steps, which say where in a sequence each message sits. Use it to see what actually went out. For per-message engagement — opens, clicks, replies — use get_apollo_emailer_messages_id_activities.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

• Method and path: GET /apis/v1/apollo/emailer_messages/search
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/apollo/emailer_messages/search
• email_account_id_and_aliases: query; optional
• emailer_campaign_ids[]: query; optional
• emailer_message_reply_classes[]: query; optional
• emailer_message_stats[]: query; optional
• not_emailer_campaign_ids[]: query; optional
• page: query; optional
• per_page: query; optional
• user_ids[]: query; optional
• Runtime facts: 9ab7612cf2d53be794cbf1d65d4a257f986ac6783e53c7c3a5d868e4593061c3

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_apollo_emailer_messages_search",
  "method": "GET",
  "path": "/apis/v1/apollo/emailer_messages/search",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Filter by email account and aliases.",
      "in": "query",
      "name": "email_account_id_and_aliases",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Only include these sequence IDs.",
      "in": "query",
      "name": "emailer_campaign_ids[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Filter by reply classes.",
      "in": "query",
      "name": "emailer_message_reply_classes[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Filter by message stats (e.g., open, click).",
      "in": "query",
      "name": "emailer_message_stats[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Exclude these sequence IDs.",
      "in": "query",
      "name": "not_emailer_campaign_ids[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Page number.",
      "in": "query",
      "name": "page",
      "required": false,
      "schema": {
        "type": "integer"
      }
    },
    {
      "description": "Results per page.",
      "in": "query",
      "name": "per_page",
      "required": false,
      "schema": {
        "type": "integer"
      }
    },
    {
      "description": "Filter by user IDs.",
      "in": "query",
      "name": "user_ids[]",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.012,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.012
• Cost contract: fixed_success
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

email_account_id_and_aliases · string

Filter by email account and aliases.

emailer_campaign_ids[] · string[]

Only include these sequence IDs.

emailer_message_reply_classes[] · string[]

Filter by reply classes.

emailer_message_stats[] · string[]

Filter by message stats (e.g., open, click).

not_emailer_campaign_ids[] · string[]

Exclude these sequence IDs.

page · integer

Page number.

per_page · integer

Results per page.

user_ids[] · string[]

Filter by user IDs.

Response

200

application/json

Successful response

emailer_messages · string[]

Outreach emails (when returned).

pagination · object

Pagination metadata (when returned).