AFaffinity
Persons

Get a Person's List Entries

Changed on

Paginate through the List Entries (AKA rows) for the given Person across all Lists. Each List Entry includes field data for the Person, including list-specific field data. Each List Entry also includes metadata about its creation, i.e., when it was added to the List and by whom.

get/v2/persons/{personId}/list-entries

Request

  • Base URL
    https://api.affinity.co
  • URL
    https://api.affinity.co/v2/persons/{personId}/list-entries
  • Auth
    HTTP bearer

Path parameters

personIdinteger required

Persons ID

Query parameters

cursorstring
Example:ICAgICAgYmVmb3JlOjo6Nw

Cursor for the next or previous page

limitinteger
Example:100

Number of items to include in the page

Response

OK

Example response

{
  "data": [
    {
      "id": 1,
      "listId": 1,
      "listName": "All companies",
      "createdAt": "2023-01-01T00:00:00Z",
      "creatorId": 1,
      "fields": [
        {
          "id": "affinity-data-location",
          "name": "Location",
          "type": "enriched",
          "enrichmentSource": "affinity-data",
          "value": {
            "type": "company-multi",
            "data": [
              {
                "id": 1,
                "name": "Horizon Technologies",
                "domain": "horizontech.com"
              },
              {
                "id": 2,
                "name": "Crestwood Capital",
                "domain": "crestwoodcap.com"
              }
            ]
          }
        }
      ]
    }
  ],
  "pagination": {
    "prevUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgYmVmb3JlOjo6Nw",
    "nextUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgIGFmdGVyOjo6NA"
  }
}

Changes

  • 187749f77548Revision changes
    • info

      added authentication authorization bad-request conflict method-not-allowed not-acceptable not-found not-implemented rate-limit server timeout unprocessable-entity unsupported-media-type validation discriminator mapping keys to the / response property for the response status

    • info

      added bad-request validation discriminator mapping keys to the / response property for the response status

    • info

      added chat-message email meeting call discriminator mapping keys to the /////// response property for the response status

    • info

      added company company-multi datetime dropdown dropdown-multi number number-multi filterable-text filterable-text-multi formula-number interaction location location-multi person person-multi ranked-dropdown text discriminator mapping keys to the //// response property for the response status

    • info

      removed the hidden enum value from the //// response property for the response status