Company - Cohorts

Retrieve cohort members for a given company.
Cohorts let you benchmark a company against its peers.

Base URL: https://api.salescaddy.ai/api

Required enum: cohort (path) must be one of Default, Defined, Aspirational (type: CohortTypeEnum).
Use pagination with page / size to iterate results.

---

Endpoint

GET /companies/{companyDomain}/cohort/{cohort}

Path parameters

Name	Type	Required	Description
companyDomain	string	Yes	Subject company domain (e.g. hilton.com)
cohort	CohortTypeEnum	Yes	One of: Default, Defined, Aspirational

Query parameters

Name	Type	Required	Default	Description
page	int	No	0	Page index (0-based)
size	int	No	20	Page size (max 200)

---

Example — Get Default cohort

Bash

curl -sS "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Default?page=0&size=10" \
  -H "Authorization: Bearer $TOKEN"

Node

const url = "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Default?page=0&size=10";
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.TOKEN}` } });
console.log(await res.json());

Python

import os, requests
r = requests.get("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Default",
                 params={"page":0,"size":10},
                 headers={"Authorization": f"Bearer {os.environ['TOKEN']}"})
print(r.json())

C#

using System.Net.Http.Headers;
var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", TOKEN);
var res = await http.GetAsync("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Default?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Sample response (trimmed):

JSON

{
  "totalPages": 5,
  "totalElements": 98,
  "content": [
    { "domain":"hyatt.com", "name":"Hyatt Hotels Corporation", "employeeRange":"5001-10000", "country":"US" },
    { "domain":"ihg.com", "name":"InterContinental Hotels Group", "employeeRange":"10001+", "country":"UK" }
  ]
}

---

Example — Defined cohort

Bash

curl -sS "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Defined?page=0&size=10" \
  -H "Authorization: Bearer $TOKEN"

Node

const url = "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Defined?page=0&size=10";
console.log(await (await fetch(url, { headers: { Authorization: `Bearer ${process.env.TOKEN}` } })).json());

Python

r = requests.get("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Defined",
                 params={"page":0,"size":10},
                 headers={"Authorization": f"Bearer {os.environ['TOKEN']}"})
print(r.json())

C#

var res = await http.GetAsync("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Defined?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

---

Example — Aspirational cohort

Bash

curl -sS "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Aspirational?page=0&size=10" \
  -H "Authorization: Bearer $TOKEN"

Node

const url = "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Aspirational?page=0&size=10";
console.log(await (await fetch(url, { headers: { Authorization: `Bearer ${process.env.TOKEN}` } })).json());

Python

r = requests.get("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Aspirational",
                 params={"page":0,"size":10},
                 headers={"Authorization": f"Bearer {os.environ['TOKEN']}"})
print(r.json())

C#

var res = await http.GetAsync("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Aspirational?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

---

Semantics of cohorts

• Default — automatically derived peer set based on industry, size, region, and stack signals.
• Defined — curated cohort (manually or via configuration) for this company.
• Aspirational — forward‑looking peer group a company aims to resemble.

Use the same cohort value when calling Usage Metrics to benchmark adoption/intensity/penetration.

---

Errors

Code	Meaning	How to fix
400	Bad request	Validate cohort value and page/size.
401	Unauthorized	Provide/refresh Bearer token.
403	Forbidden	Check client permissions.
404	Not found	Unknown companyDomain or cohort not configured.
429	Rate limit exceeded	Retry with exponential backoff; respect Retry-After.
500	Internal server error	Retry later; contact support if persistent.

---