Skip to content
Navigation
GET/companies

List companies

Returns a paginated list of companies with their member counts, ordered by name

Parameters

NameInTypeDescription
searchquerystringSearch in name and domain
company_idquerystringExact match on the external reference (external ID). Unknown references return an empty list.
tag_idquerystringRestrict to companies with at least one member carrying this user tag. Unknown or malformed IDs return an empty list.
segment_idquerystringRestrict to companies with at least one member in this segment. Unknown or malformed IDs return an empty list.
cursorquerystringPagination cursor from previous response
limitqueryintegerItems per page (max 100)(default: 20)

Response

List of companies

Returns an array of objects:

FieldTypeDescription
idrequiredstringTypeID - a type-prefixed UUID
namerequiredstring
domainrequiredstringnull
externalIdrequiredstringnullExternal system identifier, when linked
planrequiredstringnull
mrrCentsrequirednumbernullMonthly recurring revenue in minor currency units
sizerequiredstringnullCompany size band
websiterequiredstringnull
industryrequiredstringnull
sourcerequiredstringRecord origin: 'api' or 'manual'
customAttributesrequiredobjectCustom attribute key/value pairs
memberCountrequirednumberNumber of people linked to this company
createdAtrequiredstringISO 8601 timestamp
updatedAtrequiredstringISO 8601 timestamp

meta

FieldTypeDescription
paginationrequiredobject

Errors

401Unauthorized

Example request

curl \
  "https://feedback.quackback.io/api/v1/companies" \
  -H "Authorization: Bearer qb_your_api_key_here"