#What are Lists?
Lists are structured tables you can use to organize operational workflows in Bigmind. A list can represent a queue of accounts to research, companies to enrich, records waiting for review, or any other tabular process your team wants to read and write programmatically.
#Core Concepts
List
A list is the top-level table. API routes identify a list by its tableId. You can create lists, fetch a summary, inspect their columns, and delete lists that are no longer needed.
Columns
Columns define the shape of the data in a list. Each column has a stable columnId, a display name, and a data type. Use column IDs when reading, filtering, or writing cells through the API.
Rows
Rows are the records in a list. Each row has a stable row ID and a set of cells keyed by column ID. You can fetch rows by ID, fetch a row by index, query rows by cell value, add rows, and delete rows.
Cells
Cells hold the values for a row and column. Values can be simple strings, numbers, booleans, enum options, dates, or structured JSON depending on the column type. Batch cell updates let you advance workflow state without rewriting an entire row.
Filtering
Column filters let you find rows by a cell value without scanning the full list. Combine columnId, operator, query, limit, and offset to power queue-like workflows or page through matches.
GET /v1/lists/{tableId}/rows?userId={userId}&columnId={statusColumnId}&operator=eq&query=pending&limit=25&offset=0Column Value Summaries
Use column value summaries to get unique effective values and counts for analysis, such as status distributions.
GET /v1/lists/{tableId}/columns/{columnId}/values?userId={userId}&limit=25&offset=0Targetable Account Lists
Account-based lists can include a targetable account column. That column stores account domain data and can enforce unique domains so each account appears once. When uniqueness is enabled, duplicate domains must be removed before the setting can be turned on.
Targetable People
For account-based outreach workflows, targetable people helpers let you add, update, or remove people by account domain instead of manually locating the row first.
#Authentication
Include your API key in the Authorization header:
Authorization: Bearer sk_your_api_key_hereAPI keys are tenant-level credentials. Include the Bigmind userId to act as in request bodies for write endpoints, or as a query parameter for read endpoints.