v1

latestOpenAPI 3.1.1Proprietary2026-07-2687313591.4 KB
Calls

Get metadata on all 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 NameTypeAllowed OperatorsExamples
idint64=id=1|id=2|id=3
startTimedatetime>, <, >=, <=sentAt>2025-01-01T01:00:00Z
createdAtdatetime>, <, >=, <=createdAt<2025-01-01T01:00:00Z
updatedAtdatetime>, <, >=, <=updatedAt>=2025-01-01T01:00:00Z
get/v2/calls

Query parameters

cursorstring
Example:ICAgICAgYmVmb3JlOjo6Nw

Cursor for the next or previous page

limitinteger
Example:100

Number of items to include in the page

filterstring

Filter options

Response

OK

Example response

{
  "data": [
    {
      "id": 1,
      "loggingType": "manual",
      "title": "Example title",
      "startTime": "2023-01-01T00:00:00Z",
      "endTime": "2023-01-01T00:00:00Z",
      "creator": {
        "emailAddress": "john.smith@contoso.com",
        "person": {
          "id": 1,
          "firstName": "Jane",
          "lastName": "Doe",
          "primaryEmailAddress": "jane.smith@northpointvc.com",
          "type": "internal"
        }
      },
      "createdAt": "2023-01-01T00:00:00Z",
      "updatedAt": "2023-01-01T00:00:00Z",
      "attendeesPreview": {
        "data": [
          {
            "emailAddress": "john.smith@contoso.com",
            "person": {
              "id": 1,
              "firstName": "Jane",
              "lastName": "Doe",
              "primaryEmailAddress": "jane.smith@northpointvc.com",
              "type": "internal"
            }
          }
        ],
        "totalCount": 200
      }
    }
  ],
  "pagination": {
    "prevUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgYmVmb3JlOjo6Nw",
    "nextUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgIGFmdGVyOjo6NA"
  }
}