> ## Documentation Index
> Fetch the complete documentation index at: https://developer.affinity.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The Basics

The three top-level objects in Affinity are **Persons, Companies, and Opportunities**. (Note:
Companies are called Organizations in the Affinity web app.) These have profiles in the Affinity web
app and can be added to Lists.

A **List** is a spreadsheet-like collection of rows tied to Persons, Companies, or Opportunities.

* Each row on a List is a **List Entry**. A List Entry contains data and metadata about a given
  Person, Company, or Opportunity in the context of a List. This includes list-specific field data,
  and information about who added the row to the List and when.
* A given entity can be added to a List more than once. These List Entries can have different
  List-specific field data and List Entry-level metadata.

Each column on a List maps to a **Field**. Fields show up within Affinity profile pages, extensions,
and integrations. There are two categories of fields:

* **List-specific fields** are scoped to a single List. In the API, their data can only be accessed
  through the List Entry resource.
* **Global fields** belong to entities directly. These can include default fields, fields created by
  you, enrichment fields, or relationship intelligence fields. They can be accessed through the
  Person/Company/Opportunity resources and the List Entry resource.


## Related topics

- [OAuth Apps and MCP Clients (CIMD)](https://developer.affinity.co/pages/external-api-v2/oauth-apps.md)
- [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)
- [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 documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.