Skip to main content
GET
/
companies
List companies
curl --request GET \
  --url https://www.ruddr.io/api/workspace/companies \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "name": "Acme Corp",
      "isActive": true,
      "description": "Enterprise technology company.",
      "billingAddress": "100 Market St, Suite 500, San Francisco, CA 94105",
      "currency": "USD",
      "facebookUrl": "https://facebook.com/acmecorp",
      "linkedinUrl": "https://linkedin.com/company/acmecorp",
      "twitterUrl": "https://twitter.com/acmecorp",
      "websiteUrl": "https://acmecorp.com",
      "numberOfEmployees": 5000,
      "ownershipClass": "public",
      "phoneNumber": "(555) 987-6543",
      "revenue": 125000000,
      "shippingAddress": "100 Market St, Suite 500, San Francisco, CA 94105",
      "tickerSymbol": "ACME",
      "yearFounded": 1985,
      "createdAt": "2025-01-15T20:47:03.284Z",
      "modifiedAt": "2025-01-15T20:47:03.284Z",
      "companySpendTier": {
        "id": "b4e2d3f5-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
        "name": "Enterprise"
      },
      "companyType": {
        "id": "c5f3e4a6-7b8c-4d9e-0f1a-2b3c4d5e6f7a",
        "name": "Customer"
      },
      "practice": {
        "id": "d6a4f5b7-8c9d-4e0f-1a2b-3c4d5e6f7a8b",
        "name": "Technology"
      },
      "industry": {
        "id": "e7b5a6c8-9d0e-4f1a-2b3c-4d5e6f7a8b9c",
        "name": "Technology"
      },
      "owner": {
        "id": "f8c6b7d9-0e1f-4a2b-3c4d-5e6f7a8b9c0d",
        "name": "John Davis"
      },
      "sicCode": {
        "id": "a9d7c8e0-1f2a-4b3c-4d5e-6f7a8b9c0d1e",
        "code": "7372",
        "industryTitle": "Prepackaged Software"
      },
      "salesforceId": "0011600001LtMCkAAN",
      "hubspotId": "12345678"
    }
  ],
  "hasMore": false
}
An organization with which you have a history of communication or business, such as a potential client or partner. Each company can be linked to one or more contacts.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
startingAfter
string

A cursor ID (uuid) used to request the next page of results. If not provided, defaults to the first page of results.

​
endingBefore
string

A cursor ID (uuid) used to request the previous page of results. Is mutually exclusive with startingAfter.

​
limit
integer

The maximum number of results to be returned. Can be any number from 1 to 100. Defaults to 10, if not provided.

​
name
string

Filter companies by name (exact match).

Response

200

​
results
object[]

The list of results for the current page.

​
hasMore
boolean

Whether there are more results available after this page.