HEhellobonsai
Companies

List companies

Lists the companies in your CRM, a page at a time. Archived companies are left out.

Search by name before creating a company, so you update the existing record instead of adding a duplicate.

Filtering

  • filter[name] — searches company names, matching from the start of any word and ignoring case. acme finds "Acme Corp"; so does corp.
get/public-api/v1/companies

Request

  • Base URL
    https://app.hellobonsai.com
  • URL
    https://app.hellobonsai.com/public-api/v1/companies
  • Auth
    • OAuth 2
      Authorization code: https://app.hellobonsai.com/oauth/authorize
      Token URL: https://app.hellobonsai.com/oauth/token
    • or HTTP bearer

Query parameters

page[number]integer

Page to return, starting at 1.

page[size]integer

Records per page. Defaults to 25; anything above 100 is reduced to 100.

filter[name]string

Searches company names, matching from the start of any word and ignoring case.

Response

A page of companies.

Example response

{
  "data": [
    {
      "id": 42,
      "name": "Acme Corp",
      "default_contact_id": 7,
      "description": "Long standing retainer client.",
      "industry": "computers_electronics_and_technology",
      "company_size": "size_201_1000",
      "source": "organic_search",
      "linkedin": "https://linkedin.com/company/acme",
      "instagram": "https://instagram.com/acme",
      "twitter": "https://x.com/acme",
      "facebook": "https://facebook.com/acme",
      "archived_at": "2026-04-14T09:12:04.000Z",
      "created_at": "2026-04-14T09:12:04.000Z",
      "domains": [
        "example.com",
        "example.net"
      ],
      "avatar_url": "https://logo.clearbit.com/acme.com",
      "url": "https://app.hellobonsai.com/companies/42"
    }
  ],
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e",
    "pagination": {
      "page": 1,
      "page_size": 25,
      "has_more": true
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.