API Documentation
← All tools
GET
/api/v1/companies/:domainDetails
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/toolsAuthentication
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
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 10 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain(path) | string | Yes | Company web domain, e.g. example.com. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| include_embedding | boolean | No | Set 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