Companies

List Companies

List companies with optional filtering and pagination.

get/companies

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/companies
  • Auth: HTTP bearer

Query parameters

pageinteger

Page number (1-indexed)

limitinteger

Items per page (max 200)

domainstring nullable

Filter by domain (exact match)

industrystring nullable

Filter by industry (partial match)

namestring nullable

Filter by company name (partial match)

employee_count_mininteger nullable

Minimum employee count

employee_count_maxinteger nullable

Maximum employee count

countrystring nullable

Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK.

statestring nullable

Filter by state (exact match, case-insensitive; surrounding spaces ignored)

citystring nullable

Filter by city (partial match)

descriptionstring nullable

Filter by company description (partial match)

revenue_mininteger nullable

Minimum annual revenue

revenue_maxinteger nullable

Maximum annual revenue

founded_year_mininteger nullable

Minimum founding year

founded_year_maxinteger nullable

Maximum founding year

linkedin_followers_mininteger nullable

Minimum LinkedIn followers

linkedin_followers_maxinteger nullable

Maximum LinkedIn followers

include_custom_fieldsboolean

When true, each company includes a custom_fields object of custom column values keyed by column slug. Default false keeps the legacy response shape and adds no extra query.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.