/api/v1/supply-chain/searchSearch
Returns a paginated list of supply-chain records matching a full-text query, with metadata including total item count, total pages, and whether more results exist. Use it to find establishments, sponsors, or related records by keyword and to narrow results by risk class, country, sponsor, mention, exclusion status, or date ranges. Invalid query parameters return 400; an unavailable search capability returns 503; other failures return 500.
When to use it
- Search supply-chain records by keyword
- Filter establishments by risk class and country
- Find records updated since a given date
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 regulatoryApiCallsPerDay. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 30 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| risk_class | string | No | Risk classification to filter records by. |
| country | string | No | Country to filter records by. |
| sponsor | string | No | Sponsor name to filter records by. |
| mention | string | No | Text mention to filter records by. |
| exclusion | boolean | No | booleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side |
| record_date_after | string | No | Lower bound on record date, as an ISO date (YYYY-MM-DD). |
| record_date_before | string | No | Upper bound on record date, as an ISO date (YYYY-MM-DD). |
| updated_since | string | No | Only return records updated on or after this date, as an ISO date (YYYY-MM-DD). |
| sort | string | No | Default record_date (default record_date) Allowed values: record_date, updated |
| order | string | No | Default desc (default desc) Allowed values: asc, desc |
| page | number | No | Min 1; default 1 (min 1; default 1) Range: 1 to ∞ |
| limit | number | No | Range 1-100; default 20 (range 1-100; default 20) Range: 1 to 100 |
| q | string | Yes | minimum length 1 |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/supply-chain/search?q=your_q"
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