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

# Get metadata on all Calls

`GET /v2/calls`

Paginate through all calls in Affinity. Returns basic information about the call interaction
and its participants. Will only return calls that the current authenticated user has 
permission to see.

You can filter calls 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` | `>`, `<`, `>=`, `<=` | `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

- InteractionsCallPaged — CallPaged model
  - `data` InteractionsCall[], required — A page of Call results
    - `id` integer, required — The call's unique identifier
    - `loggingType` 'manual', required — Indicates how the interaction was added to Affinity: either manually by a user ('manual') or automatically through Affinity's capture process ('automated'). Currently, calls can only be logged as 'manual'.
    - `title` string, nullable, required — The call's title
    - `startTime` string, date-time, required — The timestamp of when the call starts
    - `endTime` string, date-time, nullable, required — The timestamp of when the call ends
    - `allDay` boolean, required — Whether the call 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.
    - `createdAt` string, date-time, required — The timestamp of when the call was created
    - `updatedAt` string, date-time, nullable, required — The timestamp of when the call 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)