---
title: "List companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# List companies

`GET /companies`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/companies`
- Auth: HTTP bearer

## Query parameters

- `startingAfter` string
- `endingBefore` string
- `limit` integer
- `name` string

## Response `200`

200

- object
  - `results` Company[]: The list of results for the current page.
    - `id` string: The unique identifier for the object.
    - `name` string, nullable: The name of the company.
    - `isActive` boolean: Whether the company is active.
    - `description` string, nullable: A description of the company.
    - `billingAddress` string, nullable: The billing address of the company.
    - `currency` string: The three-letter currency code for the company.
    - `facebookUrl` string, nullable: The company's Facebook URL.
    - `linkedinUrl` string, nullable: The company's LinkedIn URL.
    - `twitterUrl` string, nullable: The company's Twitter URL.
    - `websiteUrl` string, nullable: The company's website URL.
    - `numberOfEmployees` integer, nullable: The number of employees.
    - `ownershipClass` 'public' | 'private' | 'subsidiary' | 'other' | 'null', nullable: The ownership classification of the company.
    - `phoneNumber` string, nullable: The phone number of the company.
    - `revenue` number, nullable: The annual revenue of the company.
    - `shippingAddress` string, nullable: The shipping address of the company.
    - `tickerSymbol` string, nullable: The stock ticker symbol for the company.
    - `yearFounded` integer, nullable: The year the company was founded.
    - `createdAt` string, date-time: The timestamp when the object was created.
    - `modifiedAt` string, date-time: The timestamp when the object was last modified.
    - `companySpendTier` object, nullable: The company spend tier associated with this company.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the company spend tier.
    - `companyType` object, nullable: The company type associated with this company.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the company type.
    - `practice` object, nullable: The practice associated with this company.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the practice.
    - `businessUnit` object, nullable: The business unit associated with this company.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the business unit.
    - `industry` object, nullable: The industry associated with this company.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the industry.
    - `owner` object, nullable: The workspace member who owns this company.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the owner member.
    - `sicCode` object, nullable: The Standard Industrial Classification (SIC) code associated with this company.
      - `id` string: The unique identifier for the object.
      - `code` string: The SIC code value.
      - `industryTitle` string: The industry title associated with the SIC code.
    - `salesforceId` string, nullable: The Salesforce record ID for this company, if synced via Salesforce integration.
    - `hubspotId` string, nullable: The HubSpot record ID for this company, if synced via HubSpot integration.
  - `hasMore` boolean: Whether there are more results available after this page.

## Other responses

- `400`: 400
- `403`: 403

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)