---
title: "Get emails"
method: GET
path: "/api/v2/emails"
tags: ["Emails"]
---

# Get emails

`GET /api/v2/emails`

List emails.

## Query parameters

- `sort` string[]
- `filter` union — Filter schema for `email` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterEmail — Filter parameters for emails.
    - `project_id` union
      - ProjectId — unresolved $ref
      - object
        - `contains` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
    - `before` union — Filter by before.
      - object — Filter using explicit operator syntax.
        - `not_contain` Before — unresolved $ref
        - `eq` Before — unresolved $ref
        - `contains` Before — unresolved $ref
        - `not_eq` Before — unresolved $ref
      - Before — unresolved $ref
    - `thread_id` union
      - ThreadId — unresolved $ref
      - object
        - `contains` ThreadId — unresolved $ref
        - `eq` ThreadId — unresolved $ref
        - `not_eq` ThreadId — unresolved $ref
        - `not_contain` ThreadId — unresolved $ref
    - `after` union — Filter by after.
      - After — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` After — unresolved $ref
        - `not_contain` After — unresolved $ref
        - `eq` After — unresolved $ref
        - `not_eq` After — unresolved $ref
    - `proposal_id` union
      - ProposalId — unresolved $ref
      - object
        - `eq` ProposalId — unresolved $ref
        - `not_contain` ProposalId — unresolved $ref
        - `contains` ProposalId — unresolved $ref
        - `not_eq` ProposalId — unresolved $ref
    - `company_id` union — Filter by emails associated with a client company (via recipients, linked deal, invoice, or project).
      - CompanyId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_eq` CompanyId — unresolved $ref
        - `contains` CompanyId — unresolved $ref
    - `task_id` union
      - TaskId — unresolved $ref
      - object
        - `not_eq` TaskId — unresolved $ref
        - `not_contain` TaskId — unresolved $ref
        - `contains` TaskId — unresolved $ref
        - `eq` TaskId — unresolved $ref
    - `sender_or_recipient_id` union — Filter by emails where the given person is the sender or a recipient.
      - SenderOrRecipientId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` SenderOrRecipientId — unresolved $ref
        - `eq` SenderOrRecipientId — unresolved $ref
        - `not_contain` SenderOrRecipientId — unresolved $ref
        - `contains` SenderOrRecipientId — unresolved $ref
    - `status` union — Filter by email resolution status (unresolved, resolved, or dismissed).
      - object — Filter using explicit operator syntax.
        - `not_contain` Status — unresolved $ref
        - `not_eq` Status — unresolved $ref
        - `eq` Status — unresolved $ref
        - `contains` Status — unresolved $ref
      - Status — unresolved $ref
    - `id` union — Filter by email ID.
      - object — Filter using explicit operator syntax.
        - `eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
      - Id — unresolved $ref
    - `recipient_id` union — Filter by a recipient person.
      - object — Filter using explicit operator syntax.
        - `contains` RecipientId — unresolved $ref
        - `eq` RecipientId — unresolved $ref
        - `not_contain` RecipientId — unresolved $ref
        - `not_eq` RecipientId — unresolved $ref
      - RecipientId — unresolved $ref
    - `invoice_id` union
      - InvoiceId — unresolved $ref
      - object
        - `not_eq` InvoiceId — unresolved $ref
        - `not_contain` InvoiceId — unresolved $ref
        - `eq` InvoiceId — unresolved $ref
        - `contains` InvoiceId — unresolved $ref
    - `purchase_order_id` union
      - object
        - `contains` PurchaseOrderId — unresolved $ref
        - `not_eq` PurchaseOrderId — unresolved $ref
        - `eq` PurchaseOrderId — unresolved $ref
        - `not_contain` PurchaseOrderId — unresolved $ref
      - PurchaseOrderId — unresolved $ref
    - `deal_id` union
      - object
        - `eq` DealId — unresolved $ref
        - `not_contain` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
        - `not_eq` DealId — unresolved $ref
      - DealId — unresolved $ref
    - `creator_id` union — Filter by the person who sent the email.
      - CreatorId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` CreatorId — unresolved $ref
        - `not_eq` CreatorId — unresolved $ref
        - `not_contain` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection email

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)