Skip to main content
Talk to salesStart

List companies

Search and page through organization companies.

GET/api/companies/
HTTP referenceScope companies:readUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

filters is a JSON-encoded array of legacy Company filter rules; this route does not accept a filter query alias or a selection.descriptor body. See the workspace selection catalog for supported Company fields and operators. Sort defaults to name; order is asc or desc, and unsupported sort fields fall back to name. Response Company records are organization-scoped and include dynamic profile/workspace metadata.

Query parameters

  • qualified_only · optional

    boolean

    Only qualified companies. Default false.

  • include_memory · optional

    boolean

    Include unpromoted internal company memory. Default false.

  • owner_id · optional

    string

    Filter by owner user ID.

  • search · optional

    string

    Search common company fields.

  • filters · optional

    string

    JSON-encoded legacy company filter rules.

  • sort · optional

    string

    Company sort field or custom:company:<definition_id>. Default name; unsupported standard fields fall back to name.

  • order · optional

    string

    asc or desc. Default asc.

  • limit · optional

    integer

    Page size, 1-500; default 100.

  • offset · optional

    integer

    Rows to skip; default 0.

  • source_table_id · optional

    string

    Restrict results to a Research Table.

Errors

StatusMeaning
400Missing organization context, invalid filters/sort/order, out-of-range limit or offset, or invalid selection query.
401Invalid API key or missing authentication.
403Missing companies:read scope.
422Query parameter has the wrong type or cannot be parsed (for example, a non-integer limit or offset).
503Company search is unavailable or the query timed out.

Docs