# Pav API

> The Pav API and MCP server: biopharma programs, companies, clinical trials, deals, patents, and change feeds.

- [Introduction](https://docs.pav.bio/introduction.md): Structured biopharma pipeline, trial, deal and patent data over a read-only REST API and an MCP server.
- [Quickstart](https://docs.pav.bio/quickstart.md): Create a Pav API key and make your first request in two minutes.
- [Authentication](https://docs.pav.bio/authentication.md): Authenticate every request with a Pav API key in the Authorization header.
- [Rate limits and errors](https://docs.pav.bio/rate-limits.md): Request limits per API key, and the error envelope every endpoint returns.
- [Programs](https://docs.pav.bio/datasets/programs.md): Drug development programs from company-published pipelines: drug, indication, phase, modality, target, mechanism and linked trials.
- [Companies](https://docs.pav.bio/datasets/companies.md): Biopharma companies and the programs, trials, deals, patents and changes linked to them.
- [Clinical trials](https://docs.pav.bio/datasets/clinical-trials.md): ClinicalTrials.gov studies with their sponsors, outcomes and links to Pav programs and companies.
- [Deals](https://docs.pav.bio/datasets/deals.md): Biopharma M&A, licensing, collaborations, options and joint ventures, with terms, lifecycle and source documents.
- [Patents](https://docs.pav.bio/datasets/patents.md): US patent families with owners, member applications, ownership history, prosecution events and statutory term.
- [FDA records](https://docs.pav.bio/datasets/fda.md): Orange Book products, patents and exclusivities; Purple Book biologics; orphan designations; warning letters and recalls, linked to companies.
- [Changes](https://docs.pav.bio/datasets/changes.md): A feed of detected pipeline movement: programs added, removed, or changing phase.
- [Search and filters](https://docs.pav.bio/concepts/search-and-filters.md): How q and filters behave on each dataset, and which values filters accept.
- [Pagination](https://docs.pav.bio/concepts/pagination.md): Page through list endpoints with limit and offset, or with a cursor on the changes feed.
- [Coverage and sources](https://docs.pav.bio/concepts/coverage-and-sources.md): Where each dataset comes from, what it covers, and which fields are partial.
- [MCP server](https://docs.pav.bio/mcp.md): Connect Claude, Cursor or any MCP client to Pav data with one URL and your API key.
- [OpenAPI and agents](https://docs.pav.bio/openapi-and-agents.md): The machine-readable API spec, and how to give agents and code generators what they need.
- [Build a competitive landscape](https://docs.pav.bio/guides/competitive-landscape.md): Collect every program against a target, count it by phase, and pull its trials and nearest competitors.
- [Screen deals for comparables](https://docs.pav.bio/guides/deal-screening.md): Find comparable licensing and collaboration deals, rank them by stated economics, and trace each term to its source.
- [Check patents and loss of exclusivity](https://docs.pav.bio/guides/patent-loe-check.md): Collect the US patent families, Orange Book patents and exclusivities around a drug, with owners and expiry dates.
- [Track pipeline changes](https://docs.pav.bio/guides/track-pipeline-changes.md): Poll the changes feed for a watchlist of companies and report additions, removals and phase moves.
- [Search-as-you-type program suggestions](https://docs.pav.bio/api-reference/programs/search-as-you-type-program-suggestions.md): Type-ahead suggestions for a program search box. Given a partial `q=` and optional active filters, runs the same search as `GET /v1/programs` and returns the top matching programs (company, drug, indication) — not facet values. Select one and filter by its `company_id`, or submit `q=` to `GET /v1/pr…
- [List and search pipeline programs](https://docs.pav.bio/api-reference/programs/list-and-search-pipeline-programs.md): Search and filter the Pav pipeline of drug programs.
- [Get a program by id](https://docs.pav.bio/api-reference/programs/get-a-program-by-id.md): Fetch a single pipeline program by its durable Pav id, including linked clinical trials, ontology terms, and source provenance. Returns `404 not_found` if the id is unknown.
- [Find programs similar to a program](https://docs.pav.bio/api-reference/programs/find-programs-similar-to-a-program.md): Return the pipeline programs most similar to the given program, ranked by similarity. Useful for finding competitive or analogous assets. Returns `404 not_found` if the source program id is unknown.
- [List and search companies](https://docs.pav.bio/api-reference/companies/list-and-search-companies.md): List the biopharma companies Pav tracks. Provide `q=` to run relevance-ranked search that matches meaning as well as exact words; omit `q=` for a filtered, paginated listing. Filter by whether the company has a tracked pipeline (`has_pipeline`).
- [Get a company by id](https://docs.pav.bio/api-reference/companies/get-a-company-by-id.md): Fetch a single company by its durable Pav id, including headquarters and tracked asset count. Returns `404 not_found` if the id is unknown.
- [List a company's programs](https://docs.pav.bio/api-reference/companies/list-a-companys-programs.md): List the pipeline programs belonging to one company, with optional phase/modality filters and free-text `q=`. Returns `404 not_found` if the company id is unknown.
- [List a company's clinical trials](https://docs.pav.bio/api-reference/companies/list-a-companys-clinical-trials.md): List clinical trials linked to one company, in the same role-aware shape as `/v1/trials/{nct_id}` (`lead_sponsor`, `collaborators`, `sponsors`, `company_ids`, `programs`).
- [List and search clinical trials](https://docs.pav.bio/api-reference/trials/list-and-search-clinical-trials.md): List or search ClinicalTrials.gov trials with their links to Pav programs and companies. Search and browse responses report `pagination.total = null`. Relevance search rejects an explicit `sort` because it ranks by query match.
- [Get a clinical trial by NCT id](https://docs.pav.bio/api-reference/trials/get-a-clinical-trial-by-nct-id.md): Fetch a single clinical trial by its NCT id, including any linked Pav programs/companies. Returns `404 not_found` if the NCT id is unknown.
- [List and search deals](https://docs.pav.bio/api-reference/deals/list-and-search-deals.md): Biopharma deals — M&A, licensing, collaborations, options, joint ventures and distribution — from SEC filings and press releases, one row per deal with its current lifecycle state and headline economics.
- [Get a deal by id](https://docs.pav.bio/api-reference/deals/get-a-deal-by-id.md): One deal with its full terms (headline value, upfront, equity, milestones, royalties, territories, rights), its lifecycle events, and the source documents behind it. Returns `404 not_found` for an unknown id.
- [List and search patent families](https://docs.pav.bio/api-reference/patents/list-and-search-patent-families.md): US patent families from USPTO data, one row per family (a root application with its continuations, divisionals and provisionals). Every filter is optional and filters combine with AND.
- [Get a patent family by id](https://docs.pav.bio/api-reference/patents/get-a-patent-family-by-id.md): One patent family with its members, recorded ownership changes, prosecution and maintenance events, and the statutory term computed from the earliest nonprovisional filing (no term adjustments or extensions). Returns `404 not_found` for an unknown id.
- [List and search FDA records](https://docs.pav.bio/api-reference/fda/list-and-search-fda-records.md): FDA regulatory records with the applicant, sponsor or recipient linked to a Pav company where possible: Orange Book products, listed patents and exclusivities; Purple Book biologic products; orphan drug designations; warning letters; and drug/device recalls. Orange and Purple Book rows are the curre…
- [Get an FDA record by key](https://docs.pav.bio/api-reference/fda/get-an-fda-record-by-key.md): One FDA record by the `record_key` a list response returned. Orange Book, Purple Book and orphan designation keys belong to one FDA edition and stop working once FDA publishes the next edition; re-find the record with `GET /v1/fda?application_key=...` (or `product_key`, `patent_number`, `designation…
- [List pipeline change events](https://docs.pav.bio/api-reference/changes/list-pipeline-change-events.md): Detected pipeline changes, newest first: a program added (`insert`), a program changing phase or details (`update`), or a program leaving a company's pipeline (`delete`), timed by `detected_at`. Page with the returned `next_cursor` via `?cursor=`; it stays gap-free while new changes arrive. `since=`…
- [List a company's change events](https://docs.pav.bio/api-reference/changes/list-a-companys-change-events.md): Pipeline changes for one company, newest first. Same `cursor`, `next_cursor` and `include_invalidated` behavior as `GET /v1/changes`.
- [Dataset summary statistics](https://docs.pav.bio/api-reference/stats/dataset-summary-statistics.md): Aggregate counts across the Pav pipeline dataset: total programs and companies, distinct phases/modalities/indications, and program counts grouped by normalized phase and modality.
- [Webhook Reference](https://docs.pav.bio/webhooks/introduction.md): Push delivery of pipeline change events. Coming soon.

## OpenAPI Specs

- [openapi](/openapi.json)