API Documentation
← All tools
GET/api/v1/companies/:domain

Details

companiesAvailable on FreeNo success wrapper

Returns the profile for a single company identified by its domain, including its linked organizations. Call it when you already know a company's domain and need its details. Returns 404 if no company matches the domain, and 400 if the domain is malformed.

When to use it

  • Look up a company profile by domain
  • Get the organizations linked to a company

Getting started

Base URL

https://app.caelrith.com/api/v1/tools

Authentication

Include your API key in the x-api-key header.

Rate limit

Every call counts against your workspace’s daily quota for company-profiles. Exceeding it returns HTTP 429.

Plans and daily limits

PlanAvailableCalls / day
freeyes10
proyes200
custom (default)yes10,000

Plan defaults. A custom workspace may carry per-tenant overrides.

Parameters

Path parameters

ParameterTypeRequiredDescription
domain(path)stringYesCompany web domain, e.g. example.com.

Query parameters

ParameterTypeRequiredDescription
include_embeddingbooleanNoSet to false to omit the company's embedding from the response.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/companies/{domain}"

Response envelope

This endpoint returns an implicit 2xx response - there is no success flag in the body.

{
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

// No "success" flag on this endpoint - any 2xx JSON is a success.

Catalog version mcp-2026-10-28 · generated from the live MCP catalog