---
title: "Get metadata on all Emails"
method: GET
path: "/v2/emails"
tags: ["Emails"]
---

# Get metadata on all Emails

`GET /v2/emails`

Paginate through all emails in Affinity. Returns basic information about the email interaction
and its participants. Will only return emails or subject lines that the current authenticated
user has permission to see.

Email bodies (the message content) are not available through the API. Only metadata such as the
subject, participants, and timestamps is returned.

If the authenticated user does not have permission to see an email's subject, the `subject`
field is obfuscated and returned as `********` rather than the actual subject line.

You can filter emails using the `filter` query parameter. The filter parameter is a string that you can specify conditions based on the following properties.
| **Property Name** | **Type** | **Allowed Operators** | **Examples** |
|---|---|---|---|
| `id` | `int64` | `=` | `id=1\|id=2\|id=3` |
| `sentAt` | `datetime` | `>`, `<`, `>=`, `<=` | `sentAt>2025-01-01T01:00:00Z` |
| `createdAt` | `datetime` | `>`, `<`, `>=`, `<=` | `createdAt<2025-01-01T01:00:00Z` |
| `updatedAt` | `datetime` | `>`, `<`, `>=`, `<=` | `updatedAt>=2025-01-01T01:00:00Z` |

## Query parameters

- `cursor` string
- `limit` integer
- `filter` string

## Response `200`

OK

- InteractionsEmailPaged — EmailPaged model
  - `data` InteractionsEmail[], required — A page of Email results
    - `id` integer, required — The email's unique identifier
    - `sentAt` string, date-time, required — The timestamp of when the email was sent
    - `loggingType` 'automated', required — Indicates how the interaction was added to Affinity: either manually by a user ('manual') or automatically through Affinity's capture process ('automated'). Currently, emails can only be logged as 'automated'.
    - `direction` 'sent' | 'received', required — The direction of the email: 'sent' if the email was sent by an internal user and 'received' if the email was sent to an internal user.
    - `subject` string, nullable, required — The email's subject. If the authenticated user does not have permission to see the subject, it is obfuscated and returned as `********` rather than the actual subject line.
    - `createdAt` string, date-time, required — The timestamp of when the email was created
    - `updatedAt` string, date-time, nullable, required — The timestamp of when the email was updated
    - `from` Attendee, required
      - `emailAddress` string, email, nullable, required — The email addresses of the attendee
      - `person` PersonData, required
        - `id` integer, required — The persons's unique identifier
        - `firstName` string, nullable, required — The person's first name
        - `lastName` string, nullable, required — The person's last name
        - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
        - `type` 'internal' | 'collaborator' | 'external', required — The person's type. `internal` - people who are users within your Affinity instance. `collaborator` - individuals outside of your company who have read-only access to specified Affinity list views and stay updated on your firm's activities. `external` - people who are not internal nor collaborators.
    - `toParticipantsPreview` AttendeesPreview, required
      - `data` Attendee[], required — A preview of Attendees
        - `emailAddress` string, email, nullable, required — The email addresses of the attendee
        - `person` PersonData, required
          - `id` integer, required — The persons's unique identifier
          - `firstName` string, nullable, required — The person's first name
          - `lastName` string, nullable, required — The person's last name
          - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
          - `type` 'internal' | 'collaborator' | 'external', required — The person's type. `internal` - people who are users within your Affinity instance. `collaborator` - individuals outside of your company who have read-only access to specified Affinity list views and stay updated on your firm's activities. `external` - people who are not internal nor collaborators.
      - `totalCount` integer, required — The total count of Attendees
    - `ccParticipantsPreview` AttendeesPreview, required
      - `data` Attendee[], required — A preview of Attendees
        - `emailAddress` string, email, nullable, required — The email addresses of the attendee
        - `person` PersonData, required
          - `id` integer, required — The persons's unique identifier
          - `firstName` string, nullable, required — The person's first name
          - `lastName` string, nullable, required — The person's last name
          - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
          - `type` 'internal' | 'collaborator' | 'external', required — The person's type. `internal` - people who are users within your Affinity instance. `collaborator` - individuals outside of your company who have read-only access to specified Affinity list views and stay updated on your firm's activities. `external` - people who are not internal nor collaborators.
      - `totalCount` integer, required — The total count of Attendees
  - `pagination` Pagination, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)