# Affinity Developer Documentation - [Introduction](https://developer.affinity.co/pages/external-api-v2/introduction.md) - [Getting Started](https://developer.affinity.co/pages/external-api-v2/getting-started.md) - [Authentication](https://developer.affinity.co/pages/external-api-v2/authentication.md) - [Permissions](https://developer.affinity.co/pages/external-api-v2/permissions.md) - [Rate Limits](https://developer.affinity.co/pages/external-api-v2/rate-limits.md) - [Pagination](https://developer.affinity.co/pages/external-api-v2/pagination.md) - [Filtering](https://developer.affinity.co/pages/external-api-v2/filtering.md) - [Error Codes](https://developer.affinity.co/pages/external-api-v2/error-codes.md) - [Versioning](https://developer.affinity.co/pages/external-api-v2/versioning.md) - [Beta Endpoints](https://developer.affinity.co/pages/external-api-v2/beta-endpoints.md) - [The Basics](https://developer.affinity.co/pages/data-model/the-basics.md) - [Working with Field Data](https://developer.affinity.co/pages/data-model/working-with-field-data.md) - [Nested Associations](https://developer.affinity.co/pages/data-model/nested-associations.md) - [Version Migration](https://developer.affinity.co/pages/changelog/version-migration.md) - [Previous Changes](https://developer.affinity.co/pages/changelog/previous-changes.md) - [Get current user](https://developer.affinity.co/api-reference/2026-09-17/auth/get-current-user.md): Returns information about the authenticated user, their current organization, and API key permissions. Use this endpoint to verify your authentication and understand your available API access levels. - [Get metadata on all Calls](https://developer.affinity.co/api-reference/2026-09-17/calls/get-metadata-on-all-calls.md): 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. - [Get metadata on all Chat Messages](https://developer.affinity.co/api-reference/2026-09-17/chat-messages/get-metadata-on-all-chat-messages.md): Paginate through all chat messages in Affinity. Returns basic information about the chat message interaction and its participants. Will only return chat messages that the current authenticated user has permission to see. - [Get all Companies](https://developer.affinity.co/api-reference/2026-09-17/companies/get-all-companies.md): Paginate through Companies in Affinity. Returns basic information and non-list-specific field data on each Company. - [Get metadata on Company Fields](https://developer.affinity.co/api-reference/2026-09-17/companies/get-metadata-on-company-fields.md): Returns metadata on non-list-specific Company Fields. - [Get dropdown options for a Company Field](https://developer.affinity.co/api-reference/2026-09-17/companies/get-dropdown-options-for-a-company-field.md): Returns the dropdown options for a specific dropdown or ranked-dropdown field on a Company. - [Search Companies](https://developer.affinity.co/api-reference/2026-09-17/companies/search-companies.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Company](https://developer.affinity.co/api-reference/2026-09-17/companies/get-a-single-company.md): Returns basic information and non-list-specific field data on the requested Company. - [Get field values on a single Company](https://developer.affinity.co/api-reference/2026-09-17/companies/get-field-values-on-a-single-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Perform batch operations on a company's fields](https://developer.affinity.co/api-reference/2026-09-17/companies/perform-batch-operations-on-a-companys-fields.md): Perform batch operations on a company's fields. - [Get a single field value on a Company](https://developer.affinity.co/api-reference/2026-09-17/companies/get-a-single-field-value-on-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a single field value on a Company](https://developer.affinity.co/api-reference/2026-09-17/companies/update-a-single-field-value-on-a-company.md): Update a single field value on a company. - [Get values for a single field on a Company](https://developer.affinity.co/api-reference/2026-09-17/companies/get-values-for-a-single-field-on-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a Company's List Entries](https://developer.affinity.co/api-reference/2026-09-17/companies/get-a-companys-list-entries.md): 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. - [Get a Company's Lists](https://developer.affinity.co/api-reference/2026-09-17/companies/get-a-companys-lists.md): Paginate through all Lists where the given Company appears as an entry and that you have access to view. Returns basic List information for each List that contains this Company. - [Get Notes for a Company](https://developer.affinity.co/api-reference/2026-09-17/companies/get-notes-for-a-company.md): Returns relevant notes for a given company which includes directly attached notes and notes attached to persons on this company. - [Get Relationships for a Company](https://developer.affinity.co/api-reference/2026-09-17/companies/get-relationships-for-a-company.md): Returns the relationships for a given company, including the interaction score that measures the strength of each relationship based on communication patterns such as emails, meetings, and other interactions. - [Get All Company Merges](https://developer.affinity.co/api-reference/2026-09-17/company-merges/get-all-company-merges.md): Retrieve paginated company merges for the organization. - [Initiate Company Merge](https://developer.affinity.co/api-reference/2026-09-17/company-merges/initiate-company-merge.md): Initiate a company merge to combine a duplicate company profile into a primary company profile. - [Get Company Merge](https://developer.affinity.co/api-reference/2026-09-17/company-merges/get-company-merge.md): Retrieve the status and details of a specific company merge. - [Get All Company Merge Tasks](https://developer.affinity.co/api-reference/2026-09-17/company-merges/get-all-company-merge-tasks.md): Retrieve paginated company merge tasks for the organization. - [Get Company Merge Task](https://developer.affinity.co/api-reference/2026-09-17/company-merges/get-company-merge-task.md): Retrieve the status and details of a specific task for company merges. - [Get All Company Duplicate Suggestions](https://developer.affinity.co/api-reference/2026-09-17/company-duplicate-suggestions/get-all-company-duplicate-suggestions.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get All Person Duplicate Suggestions](https://developer.affinity.co/api-reference/2026-09-17/person-duplicate-suggestions/get-all-person-duplicate-suggestions.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on all Emails](https://developer.affinity.co/api-reference/2026-09-17/emails/get-metadata-on-all-emails.md): Paginate through all emails in Affinity. Returns basic information about the email interaction and its participants. Will only return emails or subject lines that the current authenticated user has permission to see. - [Send Feedback](https://developer.affinity.co/api-reference/2026-09-17/feedback/send-feedback.md): Send feedback to Affinity about a particular product area or feature. - [Get all field value changes](https://developer.affinity.co/api-reference/2026-09-17/field-value-changes/get-all-field-value-changes.md): Retrieve field value changes across all entities and fields in your Affinity workspace. - [Search Files by Keyword](https://developer.affinity.co/api-reference/2026-09-17/files/search-files-by-keyword.md): Search files by keyword. The scope of the search is controlled by the request body: - [Get Coworker Inferred Connections](https://developer.affinity.co/api-reference/2026-09-17/inferred-connections/get-coworker-inferred-connections.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get Investor-Executive Inferred Connections](https://developer.affinity.co/api-reference/2026-09-17/inferred-connections/get-investor-executive-inferred-connections.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on all Lists](https://developer.affinity.co/api-reference/2026-09-17/lists/get-metadata-on-all-lists.md): Paginate through all Lists in your organization that you have access to view. Returns basic information about each List, including name, owner, and privacy settings. - [Create a List](https://developer.affinity.co/api-reference/2026-09-17/lists/create-a-list.md): Create a new List. - [Get metadata on a single List](https://developer.affinity.co/api-reference/2026-09-17/lists/get-metadata-on-a-single-list.md): Retrieve detailed information about a specific List you have access to view. Returns List configuration including name, owner, privacy settings, and creation details. - [Get metadata on a single List's Fields](https://developer.affinity.co/api-reference/2026-09-17/lists/get-metadata-on-a-single-lists-fields.md): Returns metadata on the Fields available on a single List. - [Get dropdown options for a List Field](https://developer.affinity.co/api-reference/2026-09-17/lists/get-dropdown-options-for-a-list-field.md): Returns the dropdown options for a specific dropdown, ranked-dropdown, or status-dropdown field on a List. - [Create a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-09-17/lists/create-a-dropdown-option-for-a-list-field.md): Create a dropdown option for a List Field. - [Get a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-09-17/lists/get-a-dropdown-option-for-a-list-field.md): Get a single dropdown option for a List Field. - [Update a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-09-17/lists/update-a-dropdown-option-for-a-list-field.md): Update a dropdown option for a List Field. - [Delete a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-09-17/lists/delete-a-dropdown-option-for-a-list-field.md): Delete a dropdown option for a List Field. - [Get all List Entries on a List](https://developer.affinity.co/api-reference/2026-09-17/lists/get-all-list-entries-on-a-list.md): 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… - [Add a List Entry to a List](https://developer.affinity.co/api-reference/2026-09-17/lists/add-a-list-entry-to-a-list.md): | ⚠️ This endpoint is currently in BETA | |--| - [Search List Entries](https://developer.affinity.co/api-reference/2026-09-17/lists/search-list-entries.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single List Entry on a List](https://developer.affinity.co/api-reference/2026-09-17/lists/get-a-single-list-entry-on-a-list.md): Retrieve a single list entry. Returns basic information and field data, including list-specific field data. - [Get Field Value Changes on a List Entry](https://developer.affinity.co/api-reference/2026-09-17/lists/get-field-value-changes-on-a-list-entry.md): Paginate through the historical value changes on the fields of a List Entry. - [Get field values on a single List Entry](https://developer.affinity.co/api-reference/2026-09-17/lists/get-field-values-on-a-single-list-entry.md): Paginate through all field values on a single list entry. - [Perform batch operations on a list entry's fields](https://developer.affinity.co/api-reference/2026-09-17/lists/perform-batch-operations-on-a-list-entrys-fields.md): Perform batch operations on a list entry's fields. - [Get a single field value](https://developer.affinity.co/api-reference/2026-09-17/lists/get-a-single-field-value.md): Returns a single field value on a list entry. - [Update a single field value on a List Entry](https://developer.affinity.co/api-reference/2026-09-17/lists/update-a-single-field-value-on-a-list-entry.md): Update a single field value. Requires the "Export data from Lists" [permission](/pages/external-api-v2/permissions). - [Get values for a single field on a List Entry](https://developer.affinity.co/api-reference/2026-09-17/lists/get-values-for-a-single-field-on-a-list-entry.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on Saved Views](https://developer.affinity.co/api-reference/2026-09-17/lists/get-metadata-on-saved-views.md): Paginate through all Saved Views you have access to view for a specific List. Returns basic information about each Saved View, including name, type, and creation date. - [Get metadata on a single Saved View](https://developer.affinity.co/api-reference/2026-09-17/lists/get-metadata-on-a-single-saved-view.md): Retrieve detailed information about a specific Saved View you have access to view. Returns Saved View configuration including name, type, and creation date. - [Get all List Entries on a Saved View](https://developer.affinity.co/api-reference/2026-09-17/lists/get-all-list-entries-on-a-saved-view.md): Paginate through the List Entries (AKA rows) on a given Saved View. Use this endpoint when you need to filter entities or only want **some** field data to be returned: This endpoint respects the filters set on a Saved View via web app, and only returns field data corresponding to the columns that ha… - [Get metadata on all Meetings](https://developer.affinity.co/api-reference/2026-09-17/meetings/get-metadata-on-all-meetings.md): Paginate through all Meetings in Affinity. Returns basic information about past and future meeting interactions and its attendees. - [Get a single Meeting](https://developer.affinity.co/api-reference/2026-09-17/meetings/get-a-single-meeting.md): | ⚠️ This endpoint is currently in BETA | |--| Retrieve detailed information about a specific Meeting you have access to view. Returns meeting details including title, timing, organizer, creator, and attendee information. - [Get all Notes](https://developer.affinity.co/api-reference/2026-09-17/notes/get-all-notes.md): Returns all notes, with the exception of replies. You can filter notes 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** | |---|---|---|---| | `… - [Create a Note](https://developer.affinity.co/api-reference/2026-09-17/notes/create-a-note.md): Create a new note. By default it is authored by the calling user; set `creator` to attribute it to a different internal person in your organization. Notes can be attached directly to entities (`Persons`, `Companies`, `Opportunities`), anchored to an interaction (`meeting`, `call`, or `chat message`)… - [Search Notes by Keyword](https://developer.affinity.co/api-reference/2026-09-17/notes/search-notes-by-keyword.md): Search notes by keyword. The scope of the search is controlled by the request body: - [Get a single Note](https://developer.affinity.co/api-reference/2026-09-17/notes/get-a-single-note.md): Get a Note with a given id - [Update a single Note](https://developer.affinity.co/api-reference/2026-09-17/notes/update-a-single-note.md): Make an update to an existing note's body content or its entity associations. - [Delete a single Note](https://developer.affinity.co/api-reference/2026-09-17/notes/delete-a-single-note.md): Delete a note. You can only delete notes you created. Deleting a root note also deletes its replies (both user replies and AI Notetaker replies); deleting a reply removes only that reply. - [Get Companies attached to a Note](https://developer.affinity.co/api-reference/2026-09-17/notes/get-companies-attached-to-a-note.md): Returns directly attached companies for a given Note. - [Get Opportunities attached to a Note](https://developer.affinity.co/api-reference/2026-09-17/notes/get-opportunities-attached-to-a-note.md): Returns directly attached opportunities for a given Note. - [Get Persons attached to a Note](https://developer.affinity.co/api-reference/2026-09-17/notes/get-persons-attached-to-a-note.md): Returns directly attached persons for a given Note. - [Get replies for a Note](https://developer.affinity.co/api-reference/2026-09-17/notes/get-replies-for-a-note.md): This endpoint returns reply notes for a given note id. You can filter replies 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** | |---|---|---|-… - [Get all Opportunities](https://developer.affinity.co/api-reference/2026-09-17/opportunities/get-all-opportunities.md): Paginate through Opportunities in Affinity. Returns basic information but **not** field data on each Opportunity. - [Get a single Opportunity](https://developer.affinity.co/api-reference/2026-09-17/opportunities/get-a-single-opportunity.md): Returns basic information but **not** field data on the requested Opportunity. - [Update an Opportunity](https://developer.affinity.co/api-reference/2026-09-17/opportunities/update-an-opportunity.md): | This endpoint is currently in BETA | |--| - [Delete an Opportunity](https://developer.affinity.co/api-reference/2026-09-17/opportunities/delete-an-opportunity.md): | This endpoint is currently in BETA | |--| - [Get Notes for an Opportunity](https://developer.affinity.co/api-reference/2026-09-17/opportunities/get-notes-for-an-opportunity.md): Returns Notes for a given Opportunity which includes directly attached notes and those attached to persons on this Opportunity. - [Get All Person Merges](https://developer.affinity.co/api-reference/2026-09-17/person-merges/get-all-person-merges.md): Retrieve paginated person merges for the organization. - [Initiate Person Merge](https://developer.affinity.co/api-reference/2026-09-17/person-merges/initiate-person-merge.md): Initiate a person merge to combine a duplicate person profile into a primary person profile. - [Get Person Merge](https://developer.affinity.co/api-reference/2026-09-17/person-merges/get-person-merge.md): Retrieve the status and details of a specific person merge. - [Get All Person Merge Tasks](https://developer.affinity.co/api-reference/2026-09-17/person-merges/get-all-person-merge-tasks.md): Retrieve paginated person merge tasks for the organization. - [Get Person Merge Task](https://developer.affinity.co/api-reference/2026-09-17/person-merges/get-person-merge-task.md): Retrieve the status and details of a specific task for person merges. - [Get all Persons](https://developer.affinity.co/api-reference/2026-09-17/persons/get-all-persons.md): Paginate through Persons in Affinity. Returns basic information and non-list-specific field data on each Person. - [Create a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/create-a-person.md): This endpoint is currently in BETA. - [Get metadata on Person Fields](https://developer.affinity.co/api-reference/2026-09-17/persons/get-metadata-on-person-fields.md): Returns metadata on non-list-specific Person Fields. - [Get dropdown options for a Person Field](https://developer.affinity.co/api-reference/2026-09-17/persons/get-dropdown-options-for-a-person-field.md): Returns the dropdown options for a specific dropdown or ranked-dropdown field on a Person. - [Search Persons](https://developer.affinity.co/api-reference/2026-09-17/persons/search-persons.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Person](https://developer.affinity.co/api-reference/2026-09-17/persons/get-a-single-person.md): Returns basic information and non-list-specific field data on the requested Person. - [Delete a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/delete-a-person.md): This endpoint is currently in BETA. - [Get field values on a single Person](https://developer.affinity.co/api-reference/2026-09-17/persons/get-field-values-on-a-single-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Perform batch operations on a person's fields](https://developer.affinity.co/api-reference/2026-09-17/persons/perform-batch-operations-on-a-persons-fields.md): Perform batch operations on a person's fields. - [Get a single field on a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/get-a-single-field-on-a-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a single field value on a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/update-a-single-field-value-on-a-person.md): Update a single field value on a person. - [Get values for a single field on a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/get-values-for-a-single-field-on-a-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a Person's List Entries](https://developer.affinity.co/api-reference/2026-09-17/persons/get-a-persons-list-entries.md): 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 a Person's Lists](https://developer.affinity.co/api-reference/2026-09-17/persons/get-a-persons-lists.md): Paginate through all Lists where the given Person appears as an entry and that you have access to view. Returns basic List information for each List that contains this Person. - [Get Notes for a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/get-notes-for-a-person.md): Returns notes for a given person id which includes directly attached notes, notes on meetings this person attended, and notes where this person is mentioned. - [Get Relationships for a Person](https://developer.affinity.co/api-reference/2026-09-17/persons/get-relationships-for-a-person.md): Returns the relationships for a given person, including the interaction score that measures the strength of each relationship based on communication patterns such as emails, meetings, and other interactions. - [Get rate limit usage](https://developer.affinity.co/api-reference/2026-09-17/rate-limit/get-rate-limit-usage.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Reminders](https://developer.affinity.co/api-reference/2026-09-17/reminders/get-all-reminders.md): Returns a page of Reminders visible to the caller. - [Create a Reminder](https://developer.affinity.co/api-reference/2026-09-17/reminders/create-a-reminder.md): Creates a new Reminder. Exactly one of `company`, `person`, or `opportunity` must be provided. - [Get a single Reminder](https://developer.affinity.co/api-reference/2026-09-17/reminders/get-a-single-reminder.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a Reminder](https://developer.affinity.co/api-reference/2026-09-17/reminders/update-a-reminder.md): | ⚠️ This endpoint is currently in BETA | |--| - [Delete a Reminder](https://developer.affinity.co/api-reference/2026-09-17/reminders/delete-a-reminder.md): | ⚠️ This endpoint is currently in BETA | |--| - [Semantic Search](https://developer.affinity.co/api-reference/2026-09-17/semantic-search/semantic-search.md): Perform an AI-powered semantic search. Use the `entityType` field in the request body to specify which entity type to search. Currently only supports companies. - [Get metadata on all Teams](https://developer.affinity.co/api-reference/2026-09-17/teams/get-metadata-on-all-teams.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on a single Team](https://developer.affinity.co/api-reference/2026-09-17/teams/get-metadata-on-a-single-team.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Transcripts](https://developer.affinity.co/api-reference/2026-09-17/transcripts/get-all-transcripts.md): Paginate through all transcripts and return basic metadata only. Use the single transcript endpoint to fetch the entire transcript data. Will only return transcripts that the current authenticated user has permission to see. - [Get a single Transcript](https://developer.affinity.co/api-reference/2026-09-17/transcripts/get-a-single-transcript.md): Get a transcript with a given id with the first 100 fragments of the transcript. Use the /fragments endpoint to fetch all fragments of the transcript. - [Delete a single Transcript](https://developer.affinity.co/api-reference/2026-09-17/transcripts/delete-a-single-transcript.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get fragments of a transcript](https://developer.affinity.co/api-reference/2026-09-17/transcripts/get-fragments-of-a-transcript.md): Get fragments of a transcript given a transcript id. - [Get all Users](https://developer.affinity.co/api-reference/2026-09-17/users/get-all-users.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single User](https://developer.affinity.co/api-reference/2026-09-17/users/get-a-single-user.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Webhooks](https://developer.affinity.co/api-reference/2026-09-17/webhooks/get-all-webhooks.md): | ⚠️ This endpoint is currently in BETA | |--| - [Create a Webhook](https://developer.affinity.co/api-reference/2026-09-17/webhooks/create-a-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Webhook](https://developer.affinity.co/api-reference/2026-09-17/webhooks/get-a-single-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a Webhook](https://developer.affinity.co/api-reference/2026-09-17/webhooks/update-a-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Delete a Webhook](https://developer.affinity.co/api-reference/2026-09-17/webhooks/delete-a-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get current user](https://developer.affinity.co/api-reference/2026-07-15/auth/get-current-user.md): Returns information about the authenticated user, their current organization, and API key permissions. Use this endpoint to verify your authentication and understand your available API access levels. - [Get metadata on all Calls](https://developer.affinity.co/api-reference/2026-07-15/calls/get-metadata-on-all-calls.md): 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. - [Get metadata on all Chat Messages](https://developer.affinity.co/api-reference/2026-07-15/chat-messages/get-metadata-on-all-chat-messages.md): Paginate through all chat messages in Affinity. Returns basic information about the chat message interaction and its participants. Will only return chat messages that the current authenticated user has permission to see. - [Get all Companies](https://developer.affinity.co/api-reference/2026-07-15/companies/get-all-companies.md): Paginate through Companies in Affinity. Returns basic information and non-list-specific field data on each Company. - [Get metadata on Company Fields](https://developer.affinity.co/api-reference/2026-07-15/companies/get-metadata-on-company-fields.md): Returns metadata on non-list-specific Company Fields. - [Get dropdown options for a Company Field](https://developer.affinity.co/api-reference/2026-07-15/companies/get-dropdown-options-for-a-company-field.md): Returns the dropdown options for a specific dropdown or ranked-dropdown field on a Company. - [Search Companies](https://developer.affinity.co/api-reference/2026-07-15/companies/search-companies.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Company](https://developer.affinity.co/api-reference/2026-07-15/companies/get-a-single-company.md): Returns basic information and non-list-specific field data on the requested Company. - [Get field values on a single Company](https://developer.affinity.co/api-reference/2026-07-15/companies/get-field-values-on-a-single-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Perform batch operations on a company's fields](https://developer.affinity.co/api-reference/2026-07-15/companies/perform-batch-operations-on-a-companys-fields.md): Perform batch operations on a company's fields. - [Get a single field value on a Company](https://developer.affinity.co/api-reference/2026-07-15/companies/get-a-single-field-value-on-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a single field value on a Company](https://developer.affinity.co/api-reference/2026-07-15/companies/update-a-single-field-value-on-a-company.md): Update a single field value on a company. - [Get a Company's List Entries](https://developer.affinity.co/api-reference/2026-07-15/companies/get-a-companys-list-entries.md): 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. - [Get a Company's Lists](https://developer.affinity.co/api-reference/2026-07-15/companies/get-a-companys-lists.md): Paginate through all Lists where the given Company appears as an entry and that you have access to view. Returns basic List information for each List that contains this Company. - [Get Notes for a Company](https://developer.affinity.co/api-reference/2026-07-15/companies/get-notes-for-a-company.md): Returns relevant notes for a given company which includes directly attached notes and notes attached to persons on this company. - [Get Relationships for a Company](https://developer.affinity.co/api-reference/2026-07-15/companies/get-relationships-for-a-company.md): Returns the relationships for a given company, including the interaction score that measures the strength of each relationship based on communication patterns such as emails, meetings, and other interactions. - [Get All Company Merges](https://developer.affinity.co/api-reference/2026-07-15/company-merges/get-all-company-merges.md): Retrieve paginated company merges for the organization. - [Initiate Company Merge](https://developer.affinity.co/api-reference/2026-07-15/company-merges/initiate-company-merge.md): Initiate a company merge to combine a duplicate company profile into a primary company profile. - [Get Company Merge](https://developer.affinity.co/api-reference/2026-07-15/company-merges/get-company-merge.md): Retrieve the status and details of a specific company merge. - [Get All Company Merge Tasks](https://developer.affinity.co/api-reference/2026-07-15/company-merges/get-all-company-merge-tasks.md): Retrieve paginated company merge tasks for the organization. - [Get Company Merge Task](https://developer.affinity.co/api-reference/2026-07-15/company-merges/get-company-merge-task.md): Retrieve the status and details of a specific task for company merges. - [Get All Company Duplicate Suggestions](https://developer.affinity.co/api-reference/2026-07-15/company-duplicate-suggestions/get-all-company-duplicate-suggestions.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get All Person Duplicate Suggestions](https://developer.affinity.co/api-reference/2026-07-15/person-duplicate-suggestions/get-all-person-duplicate-suggestions.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on all Emails](https://developer.affinity.co/api-reference/2026-07-15/emails/get-metadata-on-all-emails.md): Paginate through all emails in Affinity. Returns basic information about the email interaction and its participants. Will only return emails or subject lines that the current authenticated user has permission to see. - [Send Feedback](https://developer.affinity.co/api-reference/2026-07-15/feedback/send-feedback.md): Send feedback to Affinity about a particular product area or feature. - [Get all field value changes](https://developer.affinity.co/api-reference/2026-07-15/field-value-changes/get-all-field-value-changes.md): Retrieve field value changes across all entities and fields in your Affinity workspace. - [Search Files by Keyword](https://developer.affinity.co/api-reference/2026-07-15/files/search-files-by-keyword.md): Search files by keyword. The scope of the search is controlled by the request body: - [Get Coworker Inferred Connections](https://developer.affinity.co/api-reference/2026-07-15/inferred-connections/get-coworker-inferred-connections.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get Investor-Executive Inferred Connections](https://developer.affinity.co/api-reference/2026-07-15/inferred-connections/get-investor-executive-inferred-connections.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on all Lists](https://developer.affinity.co/api-reference/2026-07-15/lists/get-metadata-on-all-lists.md): Paginate through all Lists in your organization that you have access to view. Returns basic information about each List, including name, owner, and privacy settings. - [Create a List](https://developer.affinity.co/api-reference/2026-07-15/lists/create-a-list.md): Create a new List. - [Get metadata on a single List](https://developer.affinity.co/api-reference/2026-07-15/lists/get-metadata-on-a-single-list.md): Retrieve detailed information about a specific List you have access to view. Returns List configuration including name, owner, privacy settings, and creation details. - [Get metadata on a single List's Fields](https://developer.affinity.co/api-reference/2026-07-15/lists/get-metadata-on-a-single-lists-fields.md): Returns metadata on the Fields available on a single List. - [Get dropdown options for a List Field](https://developer.affinity.co/api-reference/2026-07-15/lists/get-dropdown-options-for-a-list-field.md): Returns the dropdown options for a specific dropdown, ranked-dropdown, or status-dropdown field on a List. - [Create a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-07-15/lists/create-a-dropdown-option-for-a-list-field.md): Create a dropdown option for a List Field. - [Get a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-07-15/lists/get-a-dropdown-option-for-a-list-field.md): Get a single dropdown option for a List Field. - [Update a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-07-15/lists/update-a-dropdown-option-for-a-list-field.md): Update a dropdown option for a List Field. - [Delete a dropdown option for a List Field](https://developer.affinity.co/api-reference/2026-07-15/lists/delete-a-dropdown-option-for-a-list-field.md): Delete a dropdown option for a List Field. - [Get all List Entries on a List](https://developer.affinity.co/api-reference/2026-07-15/lists/get-all-list-entries-on-a-list.md): 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… - [Search List Entries](https://developer.affinity.co/api-reference/2026-07-15/lists/search-list-entries.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single List Entry on a List](https://developer.affinity.co/api-reference/2026-07-15/lists/get-a-single-list-entry-on-a-list.md): Retrieve a single list entry. Returns basic information and field data, including list-specific field data. - [Get Field Value Changes on a List Entry](https://developer.affinity.co/api-reference/2026-07-15/lists/get-field-value-changes-on-a-list-entry.md): Paginate through the historical value changes on the fields of a List Entry. - [Get field values on a single List Entry](https://developer.affinity.co/api-reference/2026-07-15/lists/get-field-values-on-a-single-list-entry.md): Paginate through all field values on a single list entry. - [Perform batch operations on a list entry's fields](https://developer.affinity.co/api-reference/2026-07-15/lists/perform-batch-operations-on-a-list-entrys-fields.md): Perform batch operations on a list entry's fields. - [Get a single field value](https://developer.affinity.co/api-reference/2026-07-15/lists/get-a-single-field-value.md): Returns a single field value on a list entry. - [Update a single field value on a List Entry](https://developer.affinity.co/api-reference/2026-07-15/lists/update-a-single-field-value-on-a-list-entry.md): Update a single field value. Requires the "Export data from Lists" [permission](/pages/external-api-v2/permissions). - [Get metadata on Saved Views](https://developer.affinity.co/api-reference/2026-07-15/lists/get-metadata-on-saved-views.md): Paginate through all Saved Views you have access to view for a specific List. Returns basic information about each Saved View, including name, type, and creation date. - [Get metadata on a single Saved View](https://developer.affinity.co/api-reference/2026-07-15/lists/get-metadata-on-a-single-saved-view.md): Retrieve detailed information about a specific Saved View you have access to view. Returns Saved View configuration including name, type, and creation date. - [Get all List Entries on a Saved View](https://developer.affinity.co/api-reference/2026-07-15/lists/get-all-list-entries-on-a-saved-view.md): Paginate through the List Entries (AKA rows) on a given Saved View. Use this endpoint when you need to filter entities or only want **some** field data to be returned: This endpoint respects the filters set on a Saved View via web app, and only returns field data corresponding to the columns that ha… - [Get metadata on all Meetings](https://developer.affinity.co/api-reference/2026-07-15/meetings/get-metadata-on-all-meetings.md): Paginate through all Meetings in Affinity. Returns basic information about past and future meeting interactions and its attendees. - [Get a single Meeting](https://developer.affinity.co/api-reference/2026-07-15/meetings/get-a-single-meeting.md): | ⚠️ This endpoint is currently in BETA | |--| Retrieve detailed information about a specific Meeting you have access to view. Returns meeting details including title, timing, organizer, creator, and attendee information. - [Get all Notes](https://developer.affinity.co/api-reference/2026-07-15/notes/get-all-notes.md): Returns all notes, with the exception of replies. You can filter notes 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** | |---|---|---|---| | `… - [Create a Note](https://developer.affinity.co/api-reference/2026-07-15/notes/create-a-note.md): Create a new note. By default it is authored by the calling user; set `creator` to attribute it to a different internal person in your organization. Notes can be attached directly to entities (`Persons`, `Companies`, `Opportunities`), anchored to an interaction (`meeting`, `call`, or `chat message`)… - [Search Notes by Keyword](https://developer.affinity.co/api-reference/2026-07-15/notes/search-notes-by-keyword.md): Search notes by keyword. The scope of the search is controlled by the request body: - [Get a single Note](https://developer.affinity.co/api-reference/2026-07-15/notes/get-a-single-note.md): Get a Note with a given id - [Update a single Note](https://developer.affinity.co/api-reference/2026-07-15/notes/update-a-single-note.md): Make an update to an existing note's body content or its entity associations. - [Delete a single Note](https://developer.affinity.co/api-reference/2026-07-15/notes/delete-a-single-note.md): Delete a note. You can only delete notes you created. Deleting a root note also deletes its replies (both user replies and AI Notetaker replies); deleting a reply removes only that reply. - [Get Companies attached to a Note](https://developer.affinity.co/api-reference/2026-07-15/notes/get-companies-attached-to-a-note.md): Returns directly attached companies for a given Note. - [Get Opportunities attached to a Note](https://developer.affinity.co/api-reference/2026-07-15/notes/get-opportunities-attached-to-a-note.md): Returns directly attached opportunities for a given Note. - [Get Persons attached to a Note](https://developer.affinity.co/api-reference/2026-07-15/notes/get-persons-attached-to-a-note.md): Returns directly attached persons for a given Note. - [Get replies for a Note](https://developer.affinity.co/api-reference/2026-07-15/notes/get-replies-for-a-note.md): This endpoint returns reply notes for a given note id. You can filter replies 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** | |---|---|---|-… - [Get all Opportunities](https://developer.affinity.co/api-reference/2026-07-15/opportunities/get-all-opportunities.md): Paginate through Opportunities in Affinity. Returns basic information but **not** field data on each Opportunity. - [Get a single Opportunity](https://developer.affinity.co/api-reference/2026-07-15/opportunities/get-a-single-opportunity.md): Returns basic information but **not** field data on the requested Opportunity. - [Get Notes for an Opportunity](https://developer.affinity.co/api-reference/2026-07-15/opportunities/get-notes-for-an-opportunity.md): Returns Notes for a given Opportunity which includes directly attached notes and those attached to persons on this Opportunity. - [Get All Person Merges](https://developer.affinity.co/api-reference/2026-07-15/person-merges/get-all-person-merges.md): Retrieve paginated person merges for the organization. - [Initiate Person Merge](https://developer.affinity.co/api-reference/2026-07-15/person-merges/initiate-person-merge.md): Initiate a person merge to combine a duplicate person profile into a primary person profile. - [Get Person Merge](https://developer.affinity.co/api-reference/2026-07-15/person-merges/get-person-merge.md): Retrieve the status and details of a specific person merge. - [Get All Person Merge Tasks](https://developer.affinity.co/api-reference/2026-07-15/person-merges/get-all-person-merge-tasks.md): Retrieve paginated person merge tasks for the organization. - [Get Person Merge Task](https://developer.affinity.co/api-reference/2026-07-15/person-merges/get-person-merge-task.md): Retrieve the status and details of a specific task for person merges. - [Get all Persons](https://developer.affinity.co/api-reference/2026-07-15/persons/get-all-persons.md): Paginate through Persons in Affinity. Returns basic information and non-list-specific field data on each Person. - [Create a Person](https://developer.affinity.co/api-reference/2026-07-15/persons/create-a-person.md): This endpoint is currently in BETA. - [Get metadata on Person Fields](https://developer.affinity.co/api-reference/2026-07-15/persons/get-metadata-on-person-fields.md): Returns metadata on non-list-specific Person Fields. - [Get dropdown options for a Person Field](https://developer.affinity.co/api-reference/2026-07-15/persons/get-dropdown-options-for-a-person-field.md): Returns the dropdown options for a specific dropdown or ranked-dropdown field on a Person. - [Search Persons](https://developer.affinity.co/api-reference/2026-07-15/persons/search-persons.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Person](https://developer.affinity.co/api-reference/2026-07-15/persons/get-a-single-person.md): Returns basic information and non-list-specific field data on the requested Person. - [Delete a Person](https://developer.affinity.co/api-reference/2026-07-15/persons/delete-a-person.md): This endpoint is currently in BETA. - [Get field values on a single Person](https://developer.affinity.co/api-reference/2026-07-15/persons/get-field-values-on-a-single-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Perform batch operations on a person's fields](https://developer.affinity.co/api-reference/2026-07-15/persons/perform-batch-operations-on-a-persons-fields.md): Perform batch operations on a person's fields. - [Get a single field on a Person](https://developer.affinity.co/api-reference/2026-07-15/persons/get-a-single-field-on-a-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a single field value on a Person](https://developer.affinity.co/api-reference/2026-07-15/persons/update-a-single-field-value-on-a-person.md): Update a single field value on a person. - [Get a Person's List Entries](https://developer.affinity.co/api-reference/2026-07-15/persons/get-a-persons-list-entries.md): 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 a Person's Lists](https://developer.affinity.co/api-reference/2026-07-15/persons/get-a-persons-lists.md): Paginate through all Lists where the given Person appears as an entry and that you have access to view. Returns basic List information for each List that contains this Person. - [Get Notes for a Person](https://developer.affinity.co/api-reference/2026-07-15/persons/get-notes-for-a-person.md): Returns notes for a given person id which includes directly attached notes, notes on meetings this person attended, and notes where this person is mentioned. - [Get Relationships for a Person](https://developer.affinity.co/api-reference/2026-07-15/persons/get-relationships-for-a-person.md): Returns the relationships for a given person, including the interaction score that measures the strength of each relationship based on communication patterns such as emails, meetings, and other interactions. - [Get rate limit usage](https://developer.affinity.co/api-reference/2026-07-15/rate-limit/get-rate-limit-usage.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Reminders](https://developer.affinity.co/api-reference/2026-07-15/reminders/get-all-reminders.md): Returns a page of Reminders visible to the caller. - [Create a Reminder](https://developer.affinity.co/api-reference/2026-07-15/reminders/create-a-reminder.md): Creates a new Reminder. Exactly one of `company`, `person`, or `opportunity` must be provided. - [Get a single Reminder](https://developer.affinity.co/api-reference/2026-07-15/reminders/get-a-single-reminder.md): | ⚠️ This endpoint is currently in BETA | |--| - [Delete a Reminder](https://developer.affinity.co/api-reference/2026-07-15/reminders/delete-a-reminder.md): | ⚠️ This endpoint is currently in BETA | |--| - [Semantic Search](https://developer.affinity.co/api-reference/2026-07-15/semantic-search/semantic-search.md): Perform an AI-powered semantic search. Use the `entityType` field in the request body to specify which entity type to search. Currently only supports companies. - [Get all Transcripts](https://developer.affinity.co/api-reference/2026-07-15/transcripts/get-all-transcripts.md): Paginate through all transcripts and return basic metadata only. Use the single transcript endpoint to fetch the entire transcript data. Will only return transcripts that the current authenticated user has permission to see. - [Get a single Transcript](https://developer.affinity.co/api-reference/2026-07-15/transcripts/get-a-single-transcript.md): Get a transcript with a given id with the first 100 fragments of the transcript. Use the /fragments endpoint to fetch all fragments of the transcript. - [Get fragments of a transcript](https://developer.affinity.co/api-reference/2026-07-15/transcripts/get-fragments-of-a-transcript.md): Get fragments of a transcript given a transcript id. - [Get all Users](https://developer.affinity.co/api-reference/2026-07-15/users/get-all-users.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single User](https://developer.affinity.co/api-reference/2026-07-15/users/get-a-single-user.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Webhooks](https://developer.affinity.co/api-reference/2026-07-15/webhooks/get-all-webhooks.md): | ⚠️ This endpoint is currently in BETA | |--| - [Create a Webhook](https://developer.affinity.co/api-reference/2026-07-15/webhooks/create-a-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Webhook](https://developer.affinity.co/api-reference/2026-07-15/webhooks/get-a-single-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a Webhook](https://developer.affinity.co/api-reference/2026-07-15/webhooks/update-a-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Delete a Webhook](https://developer.affinity.co/api-reference/2026-07-15/webhooks/delete-a-webhook.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get current user](https://developer.affinity.co/api-reference/2024-01-01/auth/get-current-user.md): Returns information about the authenticated user, their current organization, and API key permissions. Use this endpoint to verify your authentication and understand your available API access levels. - [Get metadata on all Calls](https://developer.affinity.co/api-reference/2024-01-01/calls/get-metadata-on-all-calls.md): 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. - [Get metadata on all Chat Messages](https://developer.affinity.co/api-reference/2024-01-01/chat-messages/get-metadata-on-all-chat-messages.md): Paginate through all chat messages in Affinity. Returns basic information about the chat message interaction and its participants. Will only return chat messages that the current authenticated user has permission to see. - [Get all Companies](https://developer.affinity.co/api-reference/2024-01-01/companies/get-all-companies.md): Paginate through Companies in Affinity. Returns basic information and non-list-specific field data on each Company. - [Get metadata on Company Fields](https://developer.affinity.co/api-reference/2024-01-01/companies/get-metadata-on-company-fields.md): Returns metadata on non-list-specific Company Fields. - [Get dropdown options for a Company Field](https://developer.affinity.co/api-reference/2024-01-01/companies/get-dropdown-options-for-a-company-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Search Companies](https://developer.affinity.co/api-reference/2024-01-01/companies/search-companies.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Company](https://developer.affinity.co/api-reference/2024-01-01/companies/get-a-single-company.md): Returns basic information and non-list-specific field data on the requested Company. - [Get field values on a single Company](https://developer.affinity.co/api-reference/2024-01-01/companies/get-field-values-on-a-single-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Perform batch operations on a company's fields](https://developer.affinity.co/api-reference/2024-01-01/companies/perform-batch-operations-on-a-companys-fields.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single field value on a Company](https://developer.affinity.co/api-reference/2024-01-01/companies/get-a-single-field-value-on-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a single field value on a Company](https://developer.affinity.co/api-reference/2024-01-01/companies/update-a-single-field-value-on-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a Company's List Entries](https://developer.affinity.co/api-reference/2024-01-01/companies/get-a-companys-list-entries.md): 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. - [Get a Company's Lists](https://developer.affinity.co/api-reference/2024-01-01/companies/get-a-companys-lists.md): Paginate through all Lists where the given Company appears as an entry and that you have access to view. Returns basic List information for each List that contains this Company. - [Get Notes for a Company](https://developer.affinity.co/api-reference/2024-01-01/companies/get-notes-for-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get Relationships for a Company](https://developer.affinity.co/api-reference/2024-01-01/companies/get-relationships-for-a-company.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get All Company Merges](https://developer.affinity.co/api-reference/2024-01-01/company-merges/get-all-company-merges.md): Retrieve paginated company merges for the organization. - [Initiate Company Merge](https://developer.affinity.co/api-reference/2024-01-01/company-merges/initiate-company-merge.md): Initiate a company merge to combine a duplicate company profile into a primary company profile. - [Get Company Merge](https://developer.affinity.co/api-reference/2024-01-01/company-merges/get-company-merge.md): Retrieve the status and details of a specific company merge. - [Get All Company Merge Tasks](https://developer.affinity.co/api-reference/2024-01-01/company-merges/get-all-company-merge-tasks.md): Retrieve paginated company merge tasks for the organization. - [Get Company Merge Task](https://developer.affinity.co/api-reference/2024-01-01/company-merges/get-company-merge-task.md): Retrieve the status and details of a specific task for company merges. - [Get metadata on all Emails](https://developer.affinity.co/api-reference/2024-01-01/emails/get-metadata-on-all-emails.md): Paginate through all emails in Affinity. Returns basic information about the email interaction and its participants. Will only return emails or subject lines that the current authenticated user has permission to see. - [Send Feedback](https://developer.affinity.co/api-reference/2024-01-01/feedback/send-feedback.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all field value changes](https://developer.affinity.co/api-reference/2024-01-01/field-value-changes/get-all-field-value-changes.md): Retrieve field value changes across all entities and fields in your Affinity workspace. - [Search Files by Keyword](https://developer.affinity.co/api-reference/2024-01-01/files/search-files-by-keyword.md): Search files by keyword. The scope of the search is controlled by the request body: - [Get Coworker Inferred Connections](https://developer.affinity.co/api-reference/2024-01-01/inferred-connections/get-coworker-inferred-connections.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get Investor-Executive Inferred Connections](https://developer.affinity.co/api-reference/2024-01-01/inferred-connections/get-investor-executive-inferred-connections.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on all Lists](https://developer.affinity.co/api-reference/2024-01-01/lists/get-metadata-on-all-lists.md): Paginate through all Lists in your organization that you have access to view. Returns basic information about each List, including name, owner, and privacy settings. - [Create a List](https://developer.affinity.co/api-reference/2024-01-01/lists/create-a-list.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get metadata on a single List](https://developer.affinity.co/api-reference/2024-01-01/lists/get-metadata-on-a-single-list.md): Retrieve detailed information about a specific List you have access to view. Returns List configuration including name, owner, privacy settings, and creation details. - [Get metadata on a single List's Fields](https://developer.affinity.co/api-reference/2024-01-01/lists/get-metadata-on-a-single-lists-fields.md): Returns metadata on the Fields available on a single List. - [Get dropdown options for a List Field](https://developer.affinity.co/api-reference/2024-01-01/lists/get-dropdown-options-for-a-list-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Create a dropdown option for a List Field](https://developer.affinity.co/api-reference/2024-01-01/lists/create-a-dropdown-option-for-a-list-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a dropdown option for a List Field](https://developer.affinity.co/api-reference/2024-01-01/lists/get-a-dropdown-option-for-a-list-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a dropdown option for a List Field](https://developer.affinity.co/api-reference/2024-01-01/lists/update-a-dropdown-option-for-a-list-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Delete a dropdown option for a List Field](https://developer.affinity.co/api-reference/2024-01-01/lists/delete-a-dropdown-option-for-a-list-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all List Entries on a List](https://developer.affinity.co/api-reference/2024-01-01/lists/get-all-list-entries-on-a-list.md): 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… - [Search List Entries](https://developer.affinity.co/api-reference/2024-01-01/lists/search-list-entries.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single List Entry on a List](https://developer.affinity.co/api-reference/2024-01-01/lists/get-a-single-list-entry-on-a-list.md): Retrieve a single list entry. Returns basic information and field data, including list-specific field data. - [Get Field Value Changes on a List Entry](https://developer.affinity.co/api-reference/2024-01-01/lists/get-field-value-changes-on-a-list-entry.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get field values on a single List Entry](https://developer.affinity.co/api-reference/2024-01-01/lists/get-field-values-on-a-single-list-entry.md): Paginate through all field values on a single list entry. - [Perform batch operations on a list entry's fields](https://developer.affinity.co/api-reference/2024-01-01/lists/perform-batch-operations-on-a-list-entrys-fields.md): Perform batch operations on a list entry's fields. - [Get a single field value](https://developer.affinity.co/api-reference/2024-01-01/lists/get-a-single-field-value.md): Returns a single field value on a list entry. - [Update a single field value on a List Entry](https://developer.affinity.co/api-reference/2024-01-01/lists/update-a-single-field-value-on-a-list-entry.md): Update a single field value. Requires the "Export data from Lists" [permission](/pages/external-api-v2/permissions). - [Get metadata on Saved Views](https://developer.affinity.co/api-reference/2024-01-01/lists/get-metadata-on-saved-views.md): Paginate through all Saved Views you have access to view for a specific List. Returns basic information about each Saved View, including name, type, and creation date. - [Get metadata on a single Saved View](https://developer.affinity.co/api-reference/2024-01-01/lists/get-metadata-on-a-single-saved-view.md): Retrieve detailed information about a specific Saved View you have access to view. Returns Saved View configuration including name, type, and creation date. - [Get all List Entries on a Saved View](https://developer.affinity.co/api-reference/2024-01-01/lists/get-all-list-entries-on-a-saved-view.md): Paginate through the List Entries (AKA rows) on a given Saved View. Use this endpoint when you need to filter entities or only want **some** field data to be returned: This endpoint respects the filters set on a Saved View via web app, and only returns field data corresponding to the columns that ha… - [Get metadata on all Meetings](https://developer.affinity.co/api-reference/2024-01-01/meetings/get-metadata-on-all-meetings.md): Paginate through all Meetings in Affinity. Returns basic information about past and future meeting interactions and its attendees. - [Get all Notes](https://developer.affinity.co/api-reference/2024-01-01/notes/get-all-notes.md): Returns all notes, with the exception of replies. You can filter notes 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** | |---|---|---|---| | `… - [Create a Note](https://developer.affinity.co/api-reference/2024-01-01/notes/create-a-note.md): Create a new note. By default it is authored by the calling user; set `creator` to attribute it to a different internal person in your organization. Notes can be attached directly to entities (`Persons`, `Companies`, `Opportunities`), anchored to an interaction (`meeting`, `call`, or `chat message`)… - [Search Notes by Keyword](https://developer.affinity.co/api-reference/2024-01-01/notes/search-notes-by-keyword.md): Search notes by keyword. The scope of the search is controlled by the request body: - [Get a single Note](https://developer.affinity.co/api-reference/2024-01-01/notes/get-a-single-note.md): Get a Note with a given id - [Update a single Note](https://developer.affinity.co/api-reference/2024-01-01/notes/update-a-single-note.md): Make an update to an existing note's body content or its entity associations. - [Delete a single Note](https://developer.affinity.co/api-reference/2024-01-01/notes/delete-a-single-note.md): Delete a note. You can only delete notes you created. Deleting a root note also deletes its replies (both user replies and AI Notetaker replies); deleting a reply removes only that reply. - [Get Companies attached to a Note](https://developer.affinity.co/api-reference/2024-01-01/notes/get-companies-attached-to-a-note.md): Returns directly attached companies for a given Note. - [Get Opportunities attached to a Note](https://developer.affinity.co/api-reference/2024-01-01/notes/get-opportunities-attached-to-a-note.md): Returns directly attached opportunities for a given Note. - [Get Persons attached to a Note](https://developer.affinity.co/api-reference/2024-01-01/notes/get-persons-attached-to-a-note.md): Returns directly attached persons for a given Note. - [Get replies for a Note](https://developer.affinity.co/api-reference/2024-01-01/notes/get-replies-for-a-note.md): This endpoint returns reply notes for a given note id. You can filter replies 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** | |---|---|---|-… - [Get all Opportunities](https://developer.affinity.co/api-reference/2024-01-01/opportunities/get-all-opportunities.md): Paginate through Opportunities in Affinity. Returns basic information but **not** field data on each Opportunity. - [Get a single Opportunity](https://developer.affinity.co/api-reference/2024-01-01/opportunities/get-a-single-opportunity.md): Returns basic information but **not** field data on the requested Opportunity. - [Get Notes for an Opportunity](https://developer.affinity.co/api-reference/2024-01-01/opportunities/get-notes-for-an-opportunity.md): Returns Notes for a given Opportunity which includes directly attached notes and those attached to persons on this Opportunity. - [Get All Person Merges](https://developer.affinity.co/api-reference/2024-01-01/person-merges/get-all-person-merges.md): Retrieve paginated person merges for the organization. - [Initiate Person Merge](https://developer.affinity.co/api-reference/2024-01-01/person-merges/initiate-person-merge.md): Initiate a person merge to combine a duplicate person profile into a primary person profile. - [Get Person Merge](https://developer.affinity.co/api-reference/2024-01-01/person-merges/get-person-merge.md): Retrieve the status and details of a specific person merge. - [Get All Person Merge Tasks](https://developer.affinity.co/api-reference/2024-01-01/person-merges/get-all-person-merge-tasks.md): Retrieve paginated person merge tasks for the organization. - [Get Person Merge Task](https://developer.affinity.co/api-reference/2024-01-01/person-merges/get-person-merge-task.md): Retrieve the status and details of a specific task for person merges. - [Get all Persons](https://developer.affinity.co/api-reference/2024-01-01/persons/get-all-persons.md): Paginate through Persons in Affinity. Returns basic information and non-list-specific field data on each Person. - [Get metadata on Person Fields](https://developer.affinity.co/api-reference/2024-01-01/persons/get-metadata-on-person-fields.md): Returns metadata on non-list-specific Person Fields. - [Get dropdown options for a Person Field](https://developer.affinity.co/api-reference/2024-01-01/persons/get-dropdown-options-for-a-person-field.md): | ⚠️ This endpoint is currently in BETA | |--| - [Search Persons](https://developer.affinity.co/api-reference/2024-01-01/persons/search-persons.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single Person](https://developer.affinity.co/api-reference/2024-01-01/persons/get-a-single-person.md): Returns basic information and non-list-specific field data on the requested Person. - [Get field values on a single Person](https://developer.affinity.co/api-reference/2024-01-01/persons/get-field-values-on-a-single-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Perform batch operations on a person's fields](https://developer.affinity.co/api-reference/2024-01-01/persons/perform-batch-operations-on-a-persons-fields.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single field on a Person](https://developer.affinity.co/api-reference/2024-01-01/persons/get-a-single-field-on-a-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Update a single field value on a Person](https://developer.affinity.co/api-reference/2024-01-01/persons/update-a-single-field-value-on-a-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a Person's List Entries](https://developer.affinity.co/api-reference/2024-01-01/persons/get-a-persons-list-entries.md): 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 a Person's Lists](https://developer.affinity.co/api-reference/2024-01-01/persons/get-a-persons-lists.md): Paginate through all Lists where the given Person appears as an entry and that you have access to view. Returns basic List information for each List that contains this Person. - [Get Notes for a Person](https://developer.affinity.co/api-reference/2024-01-01/persons/get-notes-for-a-person.md): Returns notes for a given person id which includes directly attached notes, notes on meetings this person attended, and notes where this person is mentioned. - [Get Relationships for a Person](https://developer.affinity.co/api-reference/2024-01-01/persons/get-relationships-for-a-person.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Reminders](https://developer.affinity.co/api-reference/2024-01-01/reminders/get-all-reminders.md): Returns a page of Reminders visible to the caller. - [Create a Reminder](https://developer.affinity.co/api-reference/2024-01-01/reminders/create-a-reminder.md): Creates a new Reminder. Exactly one of `company`, `person`, or `opportunity` must be provided. - [Semantic Search](https://developer.affinity.co/api-reference/2024-01-01/semantic-search/semantic-search.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get all Transcripts](https://developer.affinity.co/api-reference/2024-01-01/transcripts/get-all-transcripts.md): Paginate through all transcripts and return basic metadata only. Use the single transcript endpoint to fetch the entire transcript data. Will only return transcripts that the current authenticated user has permission to see. - [Get a single Transcript](https://developer.affinity.co/api-reference/2024-01-01/transcripts/get-a-single-transcript.md): Get a transcript with a given id with the first 100 fragments of the transcript. Use the /fragments endpoint to fetch all fragments of the transcript. - [Get fragments of a transcript](https://developer.affinity.co/api-reference/2024-01-01/transcripts/get-fragments-of-a-transcript.md): Get fragments of a transcript given a transcript id. - [Get all Users](https://developer.affinity.co/api-reference/2024-01-01/users/get-all-users.md): | ⚠️ This endpoint is currently in BETA | |--| - [Get a single User](https://developer.affinity.co/api-reference/2024-01-01/users/get-a-single-user.md): | ⚠️ This endpoint is currently in BETA | |--| - [Introduction](https://developer.affinity.co/pages/mcp/introduction.md): Connect your AI assistant to Affinity with the MCP Server - [Supported Clients](https://developer.affinity.co/pages/mcp/supported-clients.md): AI clients that can connect to the Affinity MCP Server, and how to set them up - [Claude](https://developer.affinity.co/pages/mcp/claude.md): Connect Claude Desktop, Claude Web, or Claude Code to the Affinity MCP Server - [ChatGPT](https://developer.affinity.co/pages/mcp/chatgpt.md): Connect ChatGPT to the Affinity MCP Server via the published Affinity app - [Copilot](https://developer.affinity.co/pages/mcp/copilot.md): Connect Copilot Studio, Copilot CLI, or Copilot in VS Code to the Affinity MCP Server - [Notion](https://developer.affinity.co/pages/mcp/notion.md): Connect Notion Custom Agents to the Affinity MCP Server - [Gemini](https://developer.affinity.co/pages/mcp/gemini.md): Connect Gemini to the Affinity MCP Server - [Other Clients](https://developer.affinity.co/pages/mcp/other-clients.md): Connect any MCP-compatible tool to the Affinity MCP Server - [Authentication](https://developer.affinity.co/pages/mcp/authentication.md): Learn how to authenticate with the Affinity MCP Server - [Security](https://developer.affinity.co/pages/mcp/security.md): How the Affinity MCP Server protects your data and credentials - [Available Tools](https://developer.affinity.co/pages/mcp/available-tools.md): Explore the tools and capabilities provided by the Affinity MCP Server - [Troubleshooting](https://developer.affinity.co/pages/mcp/troubleshooting.md): Diagnose and fix common issues with the Affinity MCP Server - [Local MCP](https://developer.affinity.co/pages/mcp/local-setup.md): Run the Affinity MCP server locally using STDIO - [Overview](https://developer.affinity.co/pages/data-share/overview.md): Affinity Data Share — available tables and schema reference - [Data Access](https://developer.affinity.co/pages/data-share/data_access.md): How data visibility works in the Data Share - [Deletes & Merges](https://developer.affinity.co/pages/data-share/deletes.md): How record deletions and merges are handled in the Data Share - [Refresh Cadence](https://developer.affinity.co/pages/data-share/refresh_cadence.md): How often Data Share tables are updated - [Connect Your Account](https://developer.affinity.co/pages/data-share/setup.md): Connect your Snowflake or Databricks account to Affinity Data Share - [Subdomain](https://developer.affinity.co/pages/data-share/subdomain.md): How subdomain identifies your Affinity instance - [Versioning & Deprecation](https://developer.affinity.co/pages/data-share/versioning.md): How Data Share schemas are versioned and what to expect when things change - [Example Queries](https://developer.affinity.co/pages/data-share/example_queries.md): Common SQL patterns for working with Data Share tables - [Persons](https://developer.affinity.co/pages/data-share/persons_v1_0.md) - [Companies](https://developer.affinity.co/pages/data-share/companies_v1_0.md) - [Lists](https://developer.affinity.co/pages/data-share/lists_v1_0.md) - [List Entries](https://developer.affinity.co/pages/data-share/list_entries_v1_0.md) - [Fields Metadata](https://developer.affinity.co/pages/data-share/fields_metadata_v1_0.md) - [Opportunities](https://developer.affinity.co/pages/data-share/opportunities_v1_0.md) - [Relationship Strengths](https://developer.affinity.co/pages/data-share/relationship_strengths_v1_0.md) - [Notes](https://developer.affinity.co/pages/data-share/notes_v1_0.md) - [Transcripts](https://developer.affinity.co/pages/data-share/transcripts_v1_0.md) - [Emails](https://developer.affinity.co/pages/data-share/emails_v1_0.md) - [Calls](https://developer.affinity.co/pages/data-share/calls_v1_0.md) - [Meetings](https://developer.affinity.co/pages/data-share/meetings_v1_0.md) - [Chat Messages](https://developer.affinity.co/pages/data-share/chat_messages_v1_0.md) - [Persons Value Changes](https://developer.affinity.co/pages/data-share/persons_value_changes_v1_0.md) - [Companies Value Changes](https://developer.affinity.co/pages/data-share/companies_value_changes_v1_0.md) - [Opportunities Value Changes](https://developer.affinity.co/pages/data-share/opportunities_value_changes_v1_0.md) - [List Entries Value Changes](https://developer.affinity.co/pages/data-share/list_entries_value_changes_v1_0.md) - [List Entries Persons](https://developer.affinity.co/pages/data-share/list_entries_persons_v1_0.md) - [List Entries Companies](https://developer.affinity.co/pages/data-share/list_entries_companies_v1_0.md) - [List Entries Opportunities](https://developer.affinity.co/pages/data-share/list_entries_opportunities_v1_0.md) - [Companies Persons](https://developer.affinity.co/pages/data-share/companies_persons_v1_0.md) - [Opportunities Persons](https://developer.affinity.co/pages/data-share/opportunities_persons_v1_0.md) - [Opportunities Companies](https://developer.affinity.co/pages/data-share/opportunities_companies_v1_0.md) - [Notes Persons](https://developer.affinity.co/pages/data-share/notes_persons_v1_0.md) - [Notes Companies](https://developer.affinity.co/pages/data-share/notes_companies_v1_0.md) - [Notes Opportunities](https://developer.affinity.co/pages/data-share/notes_opportunities_v1_0.md) - [Notes Meetings](https://developer.affinity.co/pages/data-share/notes_meetings_v1_0.md) - [Notes Emails](https://developer.affinity.co/pages/data-share/notes_emails_v1_0.md) - [Notes Chat Messages](https://developer.affinity.co/pages/data-share/notes_chat_messages_v1_0.md) - [Emails Persons](https://developer.affinity.co/pages/data-share/emails_persons_v1_0.md) - [Emails Companies](https://developer.affinity.co/pages/data-share/emails_companies_v1_0.md) - [Meetings Persons](https://developer.affinity.co/pages/data-share/meetings_persons_v1_0.md) - [Meetings Companies](https://developer.affinity.co/pages/data-share/meetings_companies_v1_0.md) - [Calls Persons](https://developer.affinity.co/pages/data-share/calls_persons_v1_0.md) - [Calls Companies](https://developer.affinity.co/pages/data-share/calls_companies_v1_0.md) - [Chat Messages Persons](https://developer.affinity.co/pages/data-share/chat_messages_persons_v1_0.md) - [Chat Messages Companies](https://developer.affinity.co/pages/data-share/chat_messages_companies_v1_0.md) - [Changelog](https://developer.affinity.co/pages/data-share/changelog.md): Schema changes to the Affinity Data Share ## OpenAPI Specs - [openapi-2024-01-01](/api-reference/openapi-2024-01-01.json) - [openapi-2024-01-01](/api-reference/openapi-2024-01-01.yaml) - [openapi-2026-07-15](/api-reference/openapi-2026-07-15.json) - [openapi-2026-07-15](/api-reference/openapi-2026-07-15.yaml) - [openapi](/api-reference/openapi.json) - [openapi](/api-reference/openapi.yaml) - [publish](/schema/temp/publish.yml) - [2024-01-01](/schema/temp/versions/2024-01-01.yml) - [2026-07-15](/schema/temp/versions/2026-07-15.yml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.