# drillr REST API

**Canonical:** https://apis.io/apis/drillr/drillr-rest-api/  
**Provider:** drillr Public Data API — https://apis.io/providers/drillr/  
**Base URL:** https://gateway.drillr.ai/api/v2  
**Documentation:** https://drillr.ai/docs/api

drillr REST API is one of 2 APIs that [drillr Public Data API](https://apis.io/providers/drillr/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Financial Data, Equities, SEC Filings, Fundamentals, and Earnings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

REST API exposing ~29 endpoints across company discovery, filings, signals, events, ownership, executives, financials, earnings, prices and analyst data for US, China and Japan. API-key header auth (X-API-KEY). Returns JSON with source-linked rows.

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/tickers` | Resolve or list canonical tickers |
| GET | `/api/v2/company-discovery` | Discover companies from a natural-language description |
| GET | `/api/v2/company-profile` | Get company profiles |
| GET | `/api/v2/filings` | List retained regulatory filings |
| GET | `/api/v2/filing-search` | Search retained filing text for one company |
| GET | `/api/v2/industry-inflections` | List published industry inflections |
| GET | `/api/v2/enterprise-ai-adoption` | List enterprise AI adoption observations |
| POST | `/api/v2/news-search` | Search cross-source news storylines, events and attributed claims |
| GET | `/api/v2/income-statements` | Get income statements |
| GET | `/api/v2/balance-sheets` | Get balance sheets |
| GET | `/api/v2/cash-flow-statements` | Get cash-flow statements |
| GET | `/api/v2/financial-metrics-snapshot` | Get current financial metrics |
| GET | `/api/v2/prices-historical` | Get US daily, weekly or monthly price history |
| GET | `/api/v2/prices-snapshot` | Get latest US closing-price snapshots |
| GET | `/api/v2/earnings-calendar` | Get earnings calendar entries |
| GET | `/api/v2/earnings-call-summary` | Get earnings-call summaries |
| GET | `/api/v2/insider-trades` | Get self-parsed insider holdings and transactions |
| GET | `/api/v2/institutional-holdings` | Get self-parsed institutional holdings |
| GET | `/api/v2/events` | Get the canonical company-event timeline |
| GET | `/api/v2/events-financings` | Get financing events |
| GET | `/api/v2/events-deals` | Get deal events |
| GET | `/api/v2/events-executive-changes` | Get executive-change events |
| GET | `/api/v2/events-corporate-actions` | Get corporate-action events |
| GET | `/api/v2/events-ownership` | Get ownership events |
| GET | `/api/v2/analyst-consensus` | Get self-built analyst consensus |
| GET | `/api/v2/analyst-ratings` | Get self-parsed analyst rating events |
| GET | `/api/v2/executives` | Get self-parsed executive profiles |
| GET | `/api/v2/executive-compensation` | Get self-parsed executive compensation |
| GET | `/api/v2/openapi.json` | Download the machine-readable API contract |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/drillr/refs/heads/main/openapi/drillr-openapi.json
- **Documentation** — https://drillr.ai/docs/api
- **APIReference** — https://drillr.ai/docs/api
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/drillr/refs/heads/main/apis.yml

## Other drillr Public Data API APIs (1)

- [drillr Data MCP Server](https://apis.io/apis/drillr/drillr-data-mcp-server/)

## Tags

Financial Data, Equities, SEC Filings, Fundamentals, Earnings, Ownership, Corporate Events, Analyst Ratings, news-signals, MCP, agent-native

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/drillr/drillr-rest-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/drillr/.