Affinity Logo

Affinity API Integration Profile

Information and guides about integrating with Affinity API

Add Affinity Integration to Your App
  • Get current user

    Returns metadata about the current user.

  • Get all Companies

    Paginate through Companies in Affinity. Returns basic information and non-list-specific field data on each Company.

    To retrieve field data, you must use either the fieldIds or the fieldTypes parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET /v2/companies/fields endpoint. When no fieldIds or fieldTypes are provided, Companies will be returned without any field data attached. To supply multiple fieldIds or fieldTypes parameters, generate a query string that looks like this: ?fieldIds=field-1234&fieldIds=affinity-data-location or ?fieldTypes=enriched&fieldTypes=global.

    Requires the "Export All Organizations directory" permission.

  • Get a single Company

    Returns basic information and non-list-specific field data on the requested Company.

    To retrieve field data, you must use either the fieldIds or the fieldTypes parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET /v2/companies/fields endpoint. When no fieldIds or fieldTypes are provided, Companies will be returned without any field data attached. To supply multiple fieldIds or fieldTypes parameters, generate a query string that looks like this: ?fieldIds=field-1234&fieldIds=affinity-data-location or ?fieldTypes=enriched&fieldTypes=global.

    Requires the "Export All Organizations directory" permission.

  • Get metadata on Company Fields

    Returns metadata on non-list-specific Company Fields.

    Use the returned Field IDs to request field data from the GET /v2/companies and GET /v2/companies/{id} endpoints.

  • Get a Company's Lists

    Returns metadata for all the Lists on which the given Company appears.

  • Get a Company's List Entries

    Paginate through the List Entries (AKA rows) for the given Company across all Lists. Each List Entry includes field data for the Company, 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.

    Requires the "Export data from Lists" permission.

  • Get metadata on all Lists

    Returns metadata on Lists.

  • Get metadata on a single List

    Returns metadata on a single List.

  • Get all List Entries on a List

    Paginate through the List Entries (AKA rows) on a given List. Returns basic information and field data, including list-specific field data, on each Company, Person, or Opportunity on the List. List Entries also include metadata about their creation, i.e., when they were added to the List and by whom.

    To retrieve field data, you must use either the fieldIds or the fieldTypes parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET /v2/lists/{listId}/fields endpoint. When no fieldIds or fieldTypes are provided, List Entries will be returned without any field data attached. To supply multiple fieldIds or fieldTypes parameters, generate a query string that looks like this: ?fieldIds=field-1234&fieldIds=affinity-data-location or ?fieldTypes=enriched&fieldTypes=global.

    Requires the "Export data from Lists" permission.

  • Get metadata on a single List's Fields

    Returns metadata on the Fields available on a single List.

    Use the returned Field IDs to request field data from the GET /v2/lists/{listId}/list-entries endpoint.

Build every single integration your customers need with AI

Talk to an expert