Skip to main content
GET
/
companies
/
{id}
Get a company
curl --request GET \
  --url https://www.ruddr.io/api/workspace/companies/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
}
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.

Path Parameters

id
string
required

The company uuid

Response

200

id
string

The unique identifier for the object.

name
string | null

The name of the company.

isActive
boolean

Whether the company is active.

description
string | null

A description of the company.

billingAddress
string | null

The billing address of the company.

currency
string

The three-letter currency code for the company.

facebookUrl
string | null

The company's Facebook URL.

linkedinUrl
string | null

The company's LinkedIn URL.

twitterUrl
string | null

The company's Twitter URL.

websiteUrl
string | null

The company's website URL.

numberOfEmployees
integer | null

The number of employees.

ownershipClass
enum<string> | null

The ownership classification of the company.

Available options:
public,
private,
subsidiary,
other,
null
phoneNumber
string | null

The phone number of the company.

revenue
number | null

The annual revenue of the company.

shippingAddress
string | null

The shipping address of the company.

tickerSymbol
string | null

The stock ticker symbol for the company.

yearFounded
integer | null

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

The company spend tier associated with this company.

companyType
object

The company type associated with this company.

practice
object

The practice associated with this company.

industry
object

The industry associated with this company.

owner
object

The workspace member who owns this company.

sicCode
object

The Standard Industrial Classification (SIC) code associated with this company.

salesforceId
string | null

The Salesforce record ID for this company, if synced via Salesforce integration.

hubspotId
string | null

The HubSpot record ID for this company, if synced via HubSpot integration.