Search

market-sizingAvailable on FreeNo success wrapper

Returns a paginated list of market-sizing records with metadata (page, limit, totalItems, totalPages). Call it to browse or filter market-sizing data by spending, prevalence, or drug count, or to search by text. Returns 400 for invalid query parameters, 503 when the data is unavailable on this deployment, and 500 on other failures.

When to use it

Browse market-sizing records by spending range
Filter markets by prevalence or drug count
Search market-sizing records by text

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 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
search	string	No	maximum length 500
contains	string	No	maximum length 200
has_prevalence	boolean	No	booleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side
min_spending	number	No	Lower bound on spending (alias of min_weighted).
max_spending	number	No	Upper bound on spending (alias of max_weighted).
minSpending	number	No	Lower bound on spending (alias of min_weighted).
maxSpending	number	No	Upper bound on spending (alias of max_weighted).
min_weighted	number	No	Lower bound on weighted spending.
max_weighted	number	No	Upper bound on weighted spending.
min_raw	number	No	Lower bound on raw spending.
max_raw	number	No	Upper bound on raw spending.
min_prevalence	number	No	Lower bound on prevalence.
max_prevalence	number	No	Upper bound on prevalence.
min_drug_count	number	No	Lower bound on number of drugs.
max_drug_count	number	No	Upper bound on number of drugs.
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
sort	string	No	Default total_prev_weighted (default total_prev_weighted) Allowed values: total_prev_weighted, total_raw, prevalence, drug_count, key
order	string	No	Default desc (default desc) Allowed values: asc, desc

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/market-sizing"

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