> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.tradespace.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.tradespace.io/_mcp/server.

# List emails

GraphQL QUERY

Returns a paginated collection of incoming emails.

Reference: https://developer.tradespace.io/api-reference/emails/incomingEmails

## GraphQL Schema

```graphql
query ExampleQuery($agreementIds: [String!], $archived: ArchivedEnum, $contactIds: [String!], $createdOnMax: ISO8601Date, $createdOnMin: ISO8601Date, $dealIds: [String!], $disclosureIds: [String!], $filingIds: [String!], $from: String, $ideaIds: [String!], $limit: Int, $matterTypes: [String!], $opportunityIds: [String!], $page: Int, $q: String, $receivedAtMax: ISO8601Date, $receivedAtMin: ISO8601Date, $sortDirection: SortDirectionEnum, $sortField: String, $stateEnums: [IncomingEmailStateEnum!], $tagIds: [String!], $tagNames: [String!], $updatedOnMax: ISO8601Date, $updatedOnMin: ISO8601Date, $withoutContacts: Boolean) {
  incomingEmails(agreementIds: $agreementIds, archived: $archived, contactIds: $contactIds, createdOnMax: $createdOnMax, createdOnMin: $createdOnMin, dealIds: $dealIds, disclosureIds: $disclosureIds, filingIds: $filingIds, from: $from, ideaIds: $ideaIds, limit: $limit, matterTypes: $matterTypes, opportunityIds: $opportunityIds, page: $page, q: $q, receivedAtMax: $receivedAtMax, receivedAtMin: $receivedAtMin, sortDirection: $sortDirection, sortField: $sortField, stateEnums: $stateEnums, tagIds: $tagIds, tagNames: $tagNames, updatedOnMax: $updatedOnMax, updatedOnMin: $updatedOnMin, withoutContacts: $withoutContacts) {
    collection {
      aiSummary
      archivedAt
      archivedByUser
      createdAt
      htmlBody
      id
      incomingEmailAttachments
      incomingEmailAttachmentsCount
      incomingEmailContacts
      incomingEmailContactsCount
    }
    metadata {
      count
      currentPage
      extra
      hasNextPage
      hasPreviousPage
      limitValue
      nextPage
      previousPage
      totalCount
      totalPages
    }
  }
}
```

## Variables

```json
{
  "agreementIds": [
    "example"
  ],
  "archived": "EXCLUDE",
  "contactIds": [
    "example"
  ],
  "createdOnMax": "example",
  "createdOnMin": "example",
  "dealIds": [
    "example"
  ],
  "disclosureIds": [
    "example"
  ],
  "filingIds": [
    "example"
  ],
  "from": "example",
  "ideaIds": [
    "example"
  ],
  "limit": 0,
  "matterTypes": [
    "example"
  ],
  "opportunityIds": [
    "example"
  ],
  "page": 0,
  "q": "example",
  "receivedAtMax": "example",
  "receivedAtMin": "example",
  "sortDirection": "ASC",
  "sortField": "example",
  "stateEnums": [
    "assigned"
  ],
  "tagIds": [
    "example"
  ],
  "tagNames": [
    "example"
  ],
  "updatedOnMax": "example",
  "updatedOnMin": "example",
  "withoutContacts": true
}
```