These 24 request bodies validate against the current API models. They are accepted
syntax examples, not claims that every query was executed or returned results.
Replace ID_FROM_ACCEPTED_PROFILE with an ID you accepted from professional discovery.
Use your API key with each POST request. For MCP, call the named tool with
arguments.request set to the same JSON body. Contact requests additionally need
an entitled linked Companies Radar account. See contact access, output and errors,
founder identity and details,
company/professional emails, and
LinkedIn/social references.
Real discovery responses and clearly labelled synthetic contact outputs are preserved in those guides. Download the machine-readable recipes.
POST /v1/companies/profile · MCP get_company ·
Required key scopes: companies.
{
"domain": "razorpay.com"
}Availability is not contact access or current deliverability.
POST /v1/contacts/company · MCP get_company_contacts ·
Required key scopes: contacts.
{
"domain": "razorpay.com",
"fields": [
"emails"
]
}Requires an entitled linked source account.
POST /v1/contacts/company · MCP get_company_contacts ·
Required key scopes: contacts.
{
"domain": "razorpay.com",
"fields": [
"phones"
]
}No mobile, department or WhatsApp verification is supplied.
POST /v1/contacts/company · MCP get_company_contacts ·
Required key scopes: contacts.
{
"domain": "razorpay.com",
"fields": [
"emails",
"phones"
]
}Only company attribution, not every employee's contact.
POST /v1/companies/field · MCP get_company_field ·
Required key scopes: companies.
{
"domain": "razorpay.com",
"field": "social",
"item_limit": 100
}Dated followers, observed headcount, snapshots and stored posts remain separate from email/phone retrieval.
POST /v1/companies/field · MCP get_company_field ·
Required key scopes: companies.
{
"domain": "razorpay.com",
"field": "people",
"item_limit": 100
}Names and background flags are not professional IDs or per-person CV evidence.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies.
{
"domain": "razorpay.com",
"group": "founders",
"limit": 10
}Recorded designation selection, not independently verified founders.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies.
{
"domain": "razorpay.com",
"group": "key_people",
"title": "CEO",
"limit": 5
}Title substring filter applies to key_people/founders only.
POST /v1/people/search · MCP search_people ·
Required key scopes: people.
{
"name": "Shashank Kumar",
"companies": [
"razorpay.com"
],
"limit": 3
}Inspect name, exact recorded domain and professional references before selecting an ID.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "razorpay.com",
"group": "professionals",
"roles": [
"founder"
],
"limit": 3
}Source founder tags can disagree with company founder records.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "microsoft.com",
"group": "professionals",
"limit": 5,
"page": 0
}Recorded exact affiliation, not verified current employee roster.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "stripe.com",
"group": "professionals",
"roles": [
"executive"
],
"limit": 5
}Source role classification; inspect the current title separately.
POST /v1/people/search · MCP search_people ·
Required key scopes: people.
{
"companies": [
"microsoft.com"
],
"roles": [
"board"
],
"limit": 5
}People company predicate is prefix-based; review exact domain.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "microsoft.com",
"group": "professionals",
"skills": [
"Python"
],
"limit": 5
}Returned cards expose bounded skill summaries.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "microsoft.com",
"group": "professionals",
"min_experience_years": 10,
"limit": 5
}Recorded career measure, not ten years at this company.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "stripe.com",
"group": "professionals",
"roles": [
"executive"
],
"min_seniority": "director",
"limit": 5
}Highest career seniority, not necessarily current seniority.
POST /v1/people/search · MCP search_people ·
Required key scopes: people.
{
"roles": [
"founder"
],
"locations": [
"India"
],
"limit": 5
}Location is a source professional attribute; not nationality or company incorporation.
POST /v1/people/search · MCP search_people ·
Required key scopes: people.
{
"roles": [
"founder"
],
"schools": [
"Indian Institute of Technology Roorkee"
],
"limit": 5
}Use canonical institution suggestions and inspect the returned education entries.
POST /v1/people/search · MCP search_people ·
Required key scopes: people.
{
"companies": [
"microsoft.com"
],
"degrees": [
"Computer Science"
],
"limit": 5
}Degree/major source matching, not degree verification.
POST /v1/people/filter-options · MCP people_filter_options ·
Required key scopes: people.
{
"field": "schools",
"q": "Roorkee",
"limit": 5
}Use the same field in the subsequent discovery request.
POST /v1/contacts/person · MCP get_person_contacts ·
Required key scopes: contacts.
{
"person_id": "ID_FROM_ACCEPTED_PROFILE",
"fields": [
"emails"
]
}Replace the placeholder. Source person versus company fallback is part of the result.
POST /v1/contacts/person · MCP get_person_contacts ·
Required key scopes: contacts.
{
"person_id": "ID_FROM_ACCEPTED_PROFILE",
"fields": [
"phones"
]
}A returned string does not certify a mobile or direct line.
POST /v1/contacts/person · MCP get_person_contacts ·
Required key scopes: contacts.
{
"person_id": "ID_FROM_ACCEPTED_PROFILE",
"fields": [
"emails",
"phones"
]
}One person per request; no bulk list input.
POST /v1/companies/team · MCP get_company_team ·
Required key scopes: companies, people.
{
"domain": "stripe.com",
"group": "professionals",
"roles": [
"executive"
],
"limit": 5,
"page": 1
}Keep the original filters and page size. A page is not the full roster.