List buying committee cells
Retrieve the materialized buying committee cells for one organization. The full committee is returned in a single response — this endpoint is not paginated. Cells are returned in the same seniority-row and department-column order as the product. Every cell includes its full bounded list of available ranked contacts.
A buying committee must already be configured in the workspace. The token must grant organizations:read, contacts:read, and prospector:read (or the encompassing read scope).
Candidates are a ranked sample using up to five engagement-ranked and five recently touched candidates per cell, not every eligible person. Prospector emails are intentionally withheld and returned as null, matching the buying committee view in the product. Cells without available candidates have an empty contacts array.
meta.nextCursor is always null. Pagination parameters, sorting, filters other than organizationId, and retrieving a cell by ID are not supported.
Example request:
curl --get 'https://api.commonroom.io/api/v2/buying-committee-cells' \
--header "Authorization: Bearer $COMMON_ROOM_API_TOKEN" \
--data-urlencode 'organizationId=o_123' \
--data-urlencode 'cols=recordCount'
Request
- Base URLhttps://api.commonroom.io/api/v2
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Organization ID in the authenticated workspace whose buying committee should be read
Comma-separated columns. Use recordCount to include the materialized cell count in response metadata. Contacts and other cell fields are always returned.
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.