Skip to main content

Get company

Read one organization-scoped company by ID.

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

This page documents the canonical HTTP contract for this endpoint.

The three optional inclusion flags default to true. Setting include_relationships=false skips related-summary hydration; include_provenance=false removes heavy provenance data; include_custom_fields=false omits both custom field values and their metadata. The response example is abridged; the returned record can include additional fields.

Path parameters

  • company_idrequired

    string

    Company ID.

Query parameters

  • include_custom_fields · optional

    boolean

    Include custom fields. Default true.

  • include_provenance · optional

    boolean

    Include source provenance. Default true.

  • include_relationships · optional

    boolean

    Include related records. Default true.

Errors

StatusMeaning
400Invalid company ID format or missing organization context.
401Invalid API key or missing organization context.
403Missing companies:read scope.
404Company not found.

Docs