curl --request GET \
--url https://production-api.joinrings.com/v1/companies/{company_uuid} \
--header 'x-api-key: <api-key>'import requests
url = "https://production-api.joinrings.com/v1/companies/{company_uuid}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://production-api.joinrings.com/v1/companies/{company_uuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://production-api.joinrings.com/v1/companies/{company_uuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://production-api.joinrings.com/v1/companies/{company_uuid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://production-api.joinrings.com/v1/companies/{company_uuid}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://production-api.joinrings.com/v1/companies/{company_uuid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"city": "<string>",
"country_code": "<string>",
"description": "<string>",
"last_activity_date": "<string>",
"logo_url": "<string>",
"name": "<string>",
"uuid": "<string>",
"website": "<string>",
"alternate_domain": "<string>",
"company_custom_fields": {},
"entity_lists": [
{
"name": "<string>",
"uuid": "<string>"
}
],
"facebook_url": "<string>",
"headquarters_address": "<string>",
"investor_rings_ai_scores": {
"date_string": "<string>",
"investment_success": {
"delta": 123,
"score": 123
},
"overall_investor": {
"delta": 123,
"score": 123
},
"peer_group_name": "<string>",
"success_trend": {
"delta": 123,
"score": 123
},
"syndicate_quality": {
"delta": 123,
"score": 123
}
},
"last_contact_at": "<string>",
"linkedin_url": "<string>",
"my_next_meeting_at": "<string>",
"my_next_meeting_title": "<string>",
"next_meeting_at": "<string>",
"next_meeting_title": "<string>",
"next_meeting_with_user_uuid": "<string>",
"operating_rings_ai_scores": {
"date_string": "<string>",
"growth_efficiency": {
"delta": 123,
"score": 123
},
"investment_momentum": {
"delta": 123,
"score": 123
},
"investor_quality": {
"delta": 123,
"score": 123
},
"overall_company": {
"delta": 123,
"score": 123
},
"peer_group_name": "<string>"
},
"pathpower": {
"meta": {},
"score": 123,
"strength_label": "<string>"
},
"rings_industry_tags": [
"<string>"
],
"state": "<string>",
"strongest_relationships": [
{
"internal_user_person_uuid": "<string>",
"internal_user_uuid": "<string>",
"last_engaged_at": "<string>",
"name": "<string>",
"path_power_score": 123
}
],
"twitter_url": "<string>"
}Get a company
Returns the full company record including:
- strongest_relationships: top 2 internal team members with the strongest connection into the company (use for “who internally knows Acme” without needing recommended-paths)
- pathpower: overall relationship strength score (0.0-1.0)
- next_meeting_at / my_next_meeting_at: the next scheduled meeting with anyone at the company, tenant-wide and for the calling user
- last_activity_date, entity list memberships, industry tags, Rings AI operating and investor scores, custom field values, location and social URLs.
Returns 404 if the company is not visible to your tenant.
curl --request GET \
--url https://production-api.joinrings.com/v1/companies/{company_uuid} \
--header 'x-api-key: <api-key>'import requests
url = "https://production-api.joinrings.com/v1/companies/{company_uuid}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://production-api.joinrings.com/v1/companies/{company_uuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://production-api.joinrings.com/v1/companies/{company_uuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://production-api.joinrings.com/v1/companies/{company_uuid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://production-api.joinrings.com/v1/companies/{company_uuid}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://production-api.joinrings.com/v1/companies/{company_uuid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"city": "<string>",
"country_code": "<string>",
"description": "<string>",
"last_activity_date": "<string>",
"logo_url": "<string>",
"name": "<string>",
"uuid": "<string>",
"website": "<string>",
"alternate_domain": "<string>",
"company_custom_fields": {},
"entity_lists": [
{
"name": "<string>",
"uuid": "<string>"
}
],
"facebook_url": "<string>",
"headquarters_address": "<string>",
"investor_rings_ai_scores": {
"date_string": "<string>",
"investment_success": {
"delta": 123,
"score": 123
},
"overall_investor": {
"delta": 123,
"score": 123
},
"peer_group_name": "<string>",
"success_trend": {
"delta": 123,
"score": 123
},
"syndicate_quality": {
"delta": 123,
"score": 123
}
},
"last_contact_at": "<string>",
"linkedin_url": "<string>",
"my_next_meeting_at": "<string>",
"my_next_meeting_title": "<string>",
"next_meeting_at": "<string>",
"next_meeting_title": "<string>",
"next_meeting_with_user_uuid": "<string>",
"operating_rings_ai_scores": {
"date_string": "<string>",
"growth_efficiency": {
"delta": 123,
"score": 123
},
"investment_momentum": {
"delta": 123,
"score": 123
},
"investor_quality": {
"delta": 123,
"score": 123
},
"overall_company": {
"delta": 123,
"score": 123
},
"peer_group_name": "<string>"
},
"pathpower": {
"meta": {},
"score": 123,
"strength_label": "<string>"
},
"rings_industry_tags": [
"<string>"
],
"state": "<string>",
"strongest_relationships": [
{
"internal_user_person_uuid": "<string>",
"internal_user_uuid": "<string>",
"last_engaged_at": "<string>",
"name": "<string>",
"path_power_score": 123
}
],
"twitter_url": "<string>"
}Authorizations
Path Parameters
Response
Company response schema.
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.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Most recent tenant-wide contact timestamp. Alias of last_activity_date, exposed for naming parity with CRM-style APIs — both fields always hold the same value.
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.
Title of the per-user next meeting. null when no user context is provided.
ISO 8601 timestamp of the earliest future calendar event involving this company, tenant-wide. Cancelled and deleted events are excluded. Updates as calendar changes arrive, with an hourly reconciliation pass.
Title of the tenant-wide next meeting.
UUID of the internal ring member attending the tenant-wide next meeting (prefers the organizer).
Show child attributes
Show child attributes
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes