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

# Get metadata on all Meetings

`GET /v2/meetings`

Paginate through all Meetings in Affinity. Returns basic information about past and future meeting interactions
and its attendees.

You can filter meetings 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` |
| `startTime` | `datetime` | `>`, `<`, `>=`, `<=` | `startTime>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

- InteractionsMeetingPaged — MeetingPaged model
  - `data` InteractionsMeeting[], required — A page of Meeting results
    - `id` integer, required — The meeting's unique identifier
    - `loggingType` 'automated' | 'manual', required — Indicates how the interaction was added to Affinity: either manually by a user ('manual') or automatically through Affinity's capture process ('automated').
    - `title` string, nullable, required — The meeting's title
    - `startTime` string, date-time, required — The timestamp of when the meeting starts
    - `endTime` string, date-time, nullable, required — The timestamp of when the meeting ends
    - `allDay` boolean, required — Whether the meeting is all day
    - `creator` 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.
    - `organizer` 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.
    - `createdAt` string, date-time, required — The timestamp of when the meeting was created
    - `updatedAt` string, date-time, nullable, required — The timestamp of when the meeting was updated
    - `attendeesPreview` 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)
