Skip to main content
GET
Get a company by UUID.

Authorizations

x-api-key
string
header
required

Path Parameters

company_uuid
string
required

Response

200 - application/json

Company response schema.

city
string | null
required
country_code
string | null
required
description
string | null
required
last_activity_date
string | null
required
logo_url
string | null
required
name
string | null
required
uuid
string
required
website
string | null
required
alternate_domain
string | null
company_custom_fields
Company Custom Fields · object | null

Tenant-defined internal/custom field values, keyed by the field's UUID (see the internal fields feature in the web app). Field definitions aren't discoverable via this API yet.

entity_lists
EntityListMembership · object[] | null
facebook_url
string | null
headquarters_address
string | null
investor_rings_ai_scores
InvestorRingsAiScores · object | null
last_contact_at
string | null

Most recent tenant-wide contact timestamp. Alias of last_activity_date exposed for naming parity with CRM-style APIs; both fields read from the same ActivityDateByEntity column.

linkedin_url
string | null
my_next_meeting_at
string | null

ISO 8601 timestamp of the earliest future calendar event involving this company where the calling user (x-rings-user-id) is a participant. null when no user context is provided.

my_next_meeting_title
string | null

Title of the per-user next meeting. null when no user context is provided.

next_meeting_at
string | null

ISO 8601 timestamp of the earliest future calendar event involving this company (tenant-wide). Source: Activity.kind=EVENT, start_date >= now(), non-cancelled, non-deleted, non-hidden. Listener-driven with hourly recompute fallback.

next_meeting_title
string | null

Title of the tenant-wide next meeting.

next_meeting_with_user_uuid
string | null

UsersPrivate.uuid of the internal user attending the tenant-wide next meeting (prefers organizer).

operating_rings_ai_scores
OperatingRingsAiScores · object | null
pathpower
PathPowerMetrics · object | null
rings_industry_tags
string[] | null
state
string | null
strongest_relationships
StrongestRelationship · object[] | null

Up to two tenant internal users with the strongest relationship to this company, ranked by the best priority_management.rq_pretty against any person currently affiliated with the company. Precomputed every ~3 hours and surfaced on detail + list endpoints; null when the tenant has no qualifying signals.

twitter_url
string | null