---
title: "Get sequence emails"
method: GET
path: "/v2/sequences/{sequence_id}/emails"
tags: ["Sequence Leads"]
---

# Get sequence emails

`GET /v2/sequences/{sequence_id}/emails`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/sequences/{sequence_id}/emails`
- Auth: HTTP bearer

List the outgoing emails for a specific sequence, optionally filtered by status (e.g. drafted / scheduled / sent). Provide the sequence_id. Use this to see exactly what has been drafted or sent in a campaign. Returns emails[] — each with subject, from, body content, status, scheduled_at/sent_at, `to_email` + `recipient` (who it is addressed to: the lead, or a mutual contact asked for an intro), and `person` (the sequence lead the email is about). OUTGOING only: an incoming reply is matched to its lead (finishing it — see get_sequence_leads) but no tool here returns reply content; replies live in the user's own mailbox.

## Path parameters

- `sequence_id` string, required: Encrypted sequence identifier

## Query parameters

- `status` 'draft' | 'scheduled' | 'sending' | 'sent' | 'failed' | 'canceled': Status of the outgoing email

## Response `200`

Sequence emails retrieved successfully

- object
  - `data` object, required
    - `emails` object[], required
      - `id` string, required: Encrypted email identifier
      - `sequence_id` string, required: Encrypted sequence identifier
      - `sequence_lead_id` string, required: Encrypted lead identifier
      - `subject` string, required
      - `from` string, nullable, required
      - `content` unknown
      - `status` 'draft' | 'scheduled' | 'sending' | 'sent' | 'failed' | 'canceled', required: Status of the outgoing email
      - `scheduled_at` string, date-time, nullable, required
      - `sent_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `to_email` string, nullable, required: The address the email is sent to.
      - `recipient` object, required: Who the email is addressed to. `lead` when it goes straight to the sequence lead; `introducer` when it asks a mutual contact for an intro to the lead.
        - `kind` 'lead' | 'introducer', required
        - `name` string, nullable, required
        - `linkedin_identifier` string, nullable, required
      - `person` object, nullable, required: The sequence lead this email is about. Not always the recipient.
        - `id` integer, required
        - `first_name` string, nullable, required
        - `last_name` string, nullable, required
        - `full_name` string, nullable, required
        - `linkedin_url` string, uri, nullable, required
        - `linkedin_identifier` string, nullable, required
        - `headline` string, nullable, required
        - `location` object, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `country` string, nullable, required
        - `position` object, nullable, required
          - `title` string, nullable, required
          - `company` object, nullable, required
            - `id` string, nullable, required
            - `name` string, required
            - `linkedin_url` string, uri, nullable, required
            - `domain` string, nullable, required
          - `start_date` string, nullable, required
          - `end_date` string, nullable, required
        - `image_url` string, uri, nullable, required
        - `email` string, email, nullable, required
    - `credits_low` boolean, required: True when the sequence owner's credit balance is below the per-send price — scheduled emails will keep sliding a day at a time until a top-up.
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Sequence not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)