API Documentation
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.
Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day
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"
Returns the market-sizing record for a single disease identified by its key. Call it when you already have a disease key and need its market-sizing details. Returns 404 if no disease matches the key, and 500 on an internal failure.
Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key(path) | string | Yes |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/market-sizing/{key}"