{"openapi":"3.1.0","info":{"title":"Pav Enterprise API","description":"Read-only `/v1` API over Pav's biopharma dataset: drug programs, companies, clinical trials, deals, patent families, FDA records, a change feed, and dataset stats.\n\nAuthenticate every request with a Pav API key as a bearer token: `Authorization: Bearer <api_key>`. Mint a key in [Pav developer settings](https://app.pav.bio/settings/developer).\n\nAll endpoints are `GET` and return JSON. List endpoints return a `{ data, pagination }` envelope. Pass `q=` to run relevance-ranked search that matches meaning as well as exact words; omit it for a filtered, paginated listing. Errors return `{ error: { code, message, request_id } }`.","version":"1.2.0"},"servers":[{"url":"https://api.pav.bio","description":"Production"},{"url":"/","description":"This server"}],"paths":{"/v1/programs/autocomplete":{"get":{"tags":["programs"],"summary":"Search-as-you-type program suggestions","description":"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/programs` for the full page.","operationId":"autocomplete_programs","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Partial text to search programs by.","examples":["oral GLP-1 obesity"],"title":"Q"},"description":"Partial text to search programs by."},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict suggestions to programs in these phases. Repeatable.","examples":["Phase 2"],"title":"Phase"},"description":"Restrict suggestions to programs in these phases. Repeatable."},{"name":"modality","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict to these modalities (modality token or display label). Repeatable.","examples":["small_molecule"],"title":"Modality"},"description":"Restrict to these modalities (modality token or display label). Repeatable."},{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict to these company slugs. Repeatable.","examples":["pfizer"],"title":"Company"},"description":"Restrict to these company slugs. Repeatable."},{"name":"drug","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict to these drug names. Repeatable.","examples":["danuglipron"],"title":"Drug"},"description":"Restrict to these drug names. Repeatable."},{"name":"indication","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict to these indications. Repeatable.","examples":["type 2 diabetes"],"title":"Indication"},"description":"Restrict to these indications. Repeatable."},{"name":"target","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict to these molecular targets. Repeatable. Target coverage is partial; filtering excludes programs with no published target.","examples":["GLP-1R"],"title":"Target"},"description":"Restrict to these molecular targets. Repeatable. Target coverage is partial; filtering excludes programs with no published target."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"description":"Maximum suggestions to return.","examples":[8],"default":8,"title":"Limit"},"description":"Maximum suggestions to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramSuggestion"},"title":"Response Autocomplete Programs"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/programs":{"get":{"tags":["programs"],"summary":"List and search pipeline programs","description":"Search and filter the Pav pipeline of drug programs.\n\nProvide `q=` to run relevance-ranked search that matches meaning as well as exact words (search responses report `pagination.total = null`). Omit `q=` for a filtered, sortable, paginated listing with optional exact totals via `include_total=true`. Filters and `q=` combine with AND.\n\nFilter coverage note: `target` and `modality` have partial coverage in the source data. Filtering on a sparsely populated field restricts results to programs where that field is populated, which can shrink the result set.","operationId":"list_programs","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free-text query. When present, runs relevance-ranked search that matches meaning as well as exact words.","examples":["oral GLP-1 for obesity"],"title":"Q"},"description":"Free-text query. When present, runs relevance-ranked search that matches meaning as well as exact words."},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"description":"Restrict to these Pav company ids. Repeatable.","examples":[412],"title":"Company Id"},"description":"Restrict to these Pav company ids. Repeatable."},{"name":"short_name","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Restrict to these company slugs. Repeatable.","examples":["pfizer"],"title":"Short Name"},"description":"Restrict to these company slugs. Repeatable."},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by phase. Repeatable.","examples":["Phase 2"],"title":"Phase"},"description":"Filter by phase. Repeatable."},{"name":"modality","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by modality, accepting the modality token or display label. Repeatable. Coverage is partial; filtering excludes programs with no known modality.","examples":["small_molecule"],"title":"Modality"},"description":"Filter by modality, accepting the modality token or display label. Repeatable. Coverage is partial; filtering excludes programs with no known modality."},{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by company name/slug. Repeatable.","examples":["pfizer"],"title":"Company"},"description":"Filter by company name/slug. Repeatable."},{"name":"drug","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by drug/asset name. Repeatable.","examples":["danuglipron"],"title":"Drug"},"description":"Filter by drug/asset name. Repeatable."},{"name":"indication","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by indication. Repeatable.","examples":["type 2 diabetes"],"title":"Indication"},"description":"Filter by indication. Repeatable."},{"name":"target","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by molecular target. Repeatable. Target coverage is partial; filtering excludes programs with no published target.","examples":["GLP-1R"],"title":"Target"},"description":"Filter by molecular target. Repeatable. Target coverage is partial; filtering excludes programs with no published target."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum rows to return (1-5000).","examples":[50],"default":50,"title":"Limit"},"description":"Maximum rows to return (1-5000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset for paging.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset for paging."},{"name":"include_total","in":"query","required":false,"schema":{"type":"boolean","description":"Compute the exact total match count (listing path only; ignored for relevance search).","examples":[false],"default":false,"title":"Include Total"},"description":"Compute the exact total match count (listing path only; ignored for relevance search)."},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ProgramSortKey"},{"type":"null"}],"description":"Sort column for the listing path. Ignored for relevance search.","examples":["phase"],"title":"Sort"},"description":"Sort column for the listing path. Ignored for relevance search."},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SortDirection"},{"type":"null"}],"description":"Sort direction for `sort`.","examples":["desc"],"title":"Direction"},"description":"Sort direction for `sort`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/programs/{program_id}":{"get":{"tags":["programs"],"summary":"Get a program by id","description":"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.","operationId":"get_program","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"integer","description":"Durable Pav program id.","examples":[18342],"title":"Program Id"},"description":"Durable Pav program id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Program"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/programs/{program_id}/similar-programs":{"get":{"tags":["programs"],"summary":"Find programs similar to a program","description":"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.","operationId":"get_similar_programs","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"integer","description":"Durable Pav program id to find neighbors for.","examples":[18342],"title":"Program Id"},"description":"Durable Pav program id to find neighbors for."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarProgramsResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/companies":{"get":{"tags":["companies"],"summary":"List and search companies","description":"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`).","operationId":"list_companies","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free-text query. When present, runs relevance-ranked search that matches meaning as well as exact words.","examples":["mRNA vaccine maker"],"title":"Q"},"description":"Free-text query. When present, runs relevance-ranked search that matches meaning as well as exact words."},{"name":"has_pipeline","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Restrict to companies that do (or do not) have a tracked pipeline.","examples":[true],"title":"Has Pipeline"},"description":"Restrict to companies that do (or do not) have a tracked pipeline."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum rows to return (1-5000).","examples":[50],"default":50,"title":"Limit"},"description":"Maximum rows to return (1-5000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset for paging.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset for paging."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/companies/{company_id}":{"get":{"tags":["companies"],"summary":"Get a company by id","description":"Fetch a single company by its durable Pav id, including headquarters and tracked asset count. Returns `404 not_found` if the id is unknown.","operationId":"get_company","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"integer","description":"Durable Pav company id.","examples":[412],"title":"Company Id"},"description":"Durable Pav company id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Company"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/companies/{company_id}/programs":{"get":{"tags":["companies"],"summary":"List a company's programs","description":"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.","operationId":"list_company_programs","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"integer","description":"Durable Pav company id.","examples":[412],"title":"Company Id"},"description":"Durable Pav company id."},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by phase. Repeatable.","examples":["Phase 2"],"title":"Phase"},"description":"Filter by phase. Repeatable."},{"name":"modality","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by modality (modality token or display label). Repeatable. Coverage is partial; filtering excludes programs with no known modality.","examples":["small_molecule"],"title":"Modality"},"description":"Filter by modality (modality token or display label). Repeatable. Coverage is partial; filtering excludes programs with no known modality."},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free-text query within this company's programs.","examples":["oral"],"title":"Q"},"description":"Free-text query within this company's programs."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum rows to return (1-5000).","examples":[50],"default":50,"title":"Limit"},"description":"Maximum rows to return (1-5000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset for paging.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset for paging."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/companies/{company_id}/trials":{"get":{"tags":["companies"],"summary":"List a company's clinical trials","description":"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`).\n\nA trial is linked to a company through either path:\n- **program** — a Pav program the company owns is linked to the trial (`via=program`);\n- **sponsor** — the trial's sponsor organization is linked to the company (`via=sponsor`).\n\n`via=any` (default) returns the union. Pass `include_total=true` for an exact match count. Returns `404 not_found` if the company id is unknown.","operationId":"list_company_trials","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"integer","description":"Durable Pav company id.","examples":[127],"title":"Company Id"},"description":"Durable Pav company id."},{"name":"via","in":"query","required":false,"schema":{"$ref":"#/components/schemas/TrialLinkVia","description":"Which link to follow: `program` (the company's programs), `sponsor` (the trial's sponsors), or `any` (the union, default).","examples":["any"],"default":"any"},"description":"Which link to follow: `program` (the company's programs), `sponsor` (the trial's sponsors), or `any` (the union, default)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum rows to return (1-1000).","examples":[100],"default":100,"title":"Limit"},"description":"Maximum rows to return (1-1000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset for paging.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset for paging."},{"name":"include_total","in":"query","required":false,"schema":{"type":"boolean","description":"Compute the exact total match count.","examples":[false],"default":false,"title":"Include Total"},"description":"Compute the exact total match count."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/trials":{"get":{"tags":["trials"],"summary":"List and search clinical trials","description":"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.","operationId":"list_trials","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free-text query. When present, runs relevance-ranked search that matches meaning as well as exact words.","examples":["mRNA vaccine phase 3"],"title":"Q"},"description":"Free-text query. When present, runs relevance-ranked search that matches meaning as well as exact words."},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by trial phase. Repeatable.","examples":["Phase 3"],"title":"Phase"},"description":"Filter by trial phase. Repeatable."},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by recruitment/operational status. Repeatable.","examples":["Recruiting"],"title":"Status"},"description":"Filter by recruitment/operational status. Repeatable."},{"name":"sponsor","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by lead sponsor. Repeatable.","examples":["Pfizer"],"title":"Sponsor"},"description":"Filter by lead sponsor. Repeatable."},{"name":"study_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by study type. Repeatable.","examples":["Interventional"],"title":"Study Type"},"description":"Filter by study type. Repeatable."},{"name":"nct_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Fetch specific trials by NCT id. Repeatable.","examples":["NCT04368728"],"title":"Nct Id"},"description":"Fetch specific trials by NCT id. Repeatable."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum rows to return (1-1000).","examples":[100],"default":100,"title":"Limit"},"description":"Maximum rows to return (1-1000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset for paging.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset for paging."},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TrialSortKey"},{"type":"null"}],"description":"Sort column for the listing path. Ignored for relevance search.","examples":["start_date"],"title":"Sort"},"description":"Sort column for the listing path. Ignored for relevance search."},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SortDirection"},{"type":"null"}],"description":"Sort direction for `sort`.","examples":["desc"],"title":"Direction"},"description":"Sort direction for `sort`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/trials/{nct_id}":{"get":{"tags":["trials"],"summary":"Get a clinical trial by NCT id","description":"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.","operationId":"get_trial","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"nct_id","in":"path","required":true,"schema":{"type":"string","description":"ClinicalTrials.gov NCT identifier.","examples":["NCT04368728"],"title":"Nct Id"},"description":"ClinicalTrials.gov NCT identifier."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Trial"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/deals":{"get":{"tags":["deals"],"summary":"List and search deals","description":"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.\n\nEvery filter is optional and filters combine with AND. `q` is an exact-term match (word forms such as plurals also match; every term must match) over the deal name, event headline, summary and rights, or a substring of a party's name. It does not expand synonyms, so search each phrasing you care about. With no filters you get the most recent deal activity.","operationId":"list_deals","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exact-term text or party-name substring.","examples":["Bio-Techne"],"title":"Q"},"description":"Exact-term text or party-name substring."},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"description":"Deals with any of these Pav company ids as a party. Repeatable.","title":"Company Id"},"description":"Deals with any of these Pav company ids as a party. Repeatable."},{"name":"deal_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["acquisition","merger","asset_purchase","licensing","collaboration","option","joint_venture","distribution","other"],"type":"string"}},{"type":"null"}],"description":"Restrict to these deal types. Repeatable.","examples":["licensing"],"title":"Deal Type"},"description":"Restrict to these deal types. Repeatable."},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["proposed","announced","completed","amended","terminated","update"],"type":"string"}},{"type":"null"}],"description":"Restrict to deals whose current lifecycle state is one of these. Repeatable.","examples":["completed"],"title":"Event Type"},"description":"Restrict to deals whose current lifecycle state is one of these. Repeatable."},{"name":"announced_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Announced on or after this date (inclusive).","title":"Announced From"},"description":"Announced on or after this date (inclusive)."},{"name":"announced_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Announced on or before this date (inclusive).","title":"Announced To"},"description":"Announced on or before this date (inclusive)."},{"name":"min_value_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Minimum headline deal value in USD. Only USD deals with a stated headline value qualify; many deals disclose none.","examples":[1000000000],"title":"Min Value Usd"},"description":"Minimum headline deal value in USD. Only USD deals with a stated headline value qualify; many deals disclose none."},{"name":"sort","in":"query","required":false,"schema":{"enum":["latest_activity","announced_at","completed_at","headline_value"],"type":"string","description":"`latest_activity` (default), `announced_at`, `completed_at`, or `headline_value`; newest or largest first.","default":"latest_activity","title":"Sort"},"description":"`latest_activity` (default), `announced_at`, `completed_at`, or `headline_value`; newest or largest first."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Rows per page (1-100).","default":25,"title":"Limit"},"description":"Rows per page (1-100)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"description":"Zero-based row offset for paging.","default":0,"title":"Offset"},"description":"Zero-based row offset for paging."},{"name":"include_total","in":"query","required":false,"schema":{"type":"boolean","description":"Compute the exact total match count.","default":false,"title":"Include Total"},"description":"Compute the exact total match count."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/deals/{deal_id}":{"get":{"tags":["deals"],"summary":"Get a deal by id","description":"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.","operationId":"get_deal","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Stable Pav deal id.","examples":["ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"],"title":"Deal Id"},"description":"Stable Pav deal id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealDetail"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/patents":{"get":{"tags":["patents"],"summary":"List and search patent families","description":"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.\n\n`company_id` matches families whose live members are owned by that company, as recorded in USPTO assignments. About a quarter of families map to a company, so no rows for a company does not mean it holds no patents. A lapsed family has no live owners, so `company_id` with `state=lapsed` returns nothing.","operationId":"list_patents","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring of the title, an owner name, or a member's patent number.","examples":["GLP-1"],"title":"Q"},"description":"Substring of the title, an owner name, or a member's patent number."},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"description":"Families owned by any of these Pav company ids. Repeatable.","title":"Company Id"},"description":"Families owned by any of these Pav company ids. Repeatable."},{"name":"cpc","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"description":"CPC classification prefix on any member, e.g. `A61K` or `C07K`.","examples":["A61K"],"title":"Cpc"},"description":"CPC classification prefix on any member, e.g. `A61K` or `C07K`."},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"enum":["live","lapsed"],"type":"string"},{"type":"null"}],"description":"`live` (a member pending or in force) or `lapsed` (none).","title":"State"},"description":"`live` (a member pending or in force) or `lapsed` (none)."},{"name":"granted","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: at least one granted patent; `false`: none granted.","title":"Granted"},"description":"`true`: at least one granted patent; `false`: none granted."},{"name":"priority_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Earliest priority date on or after (inclusive).","title":"Priority From"},"description":"Earliest priority date on or after (inclusive)."},{"name":"priority_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Earliest priority date on or before (inclusive).","title":"Priority To"},"description":"Earliest priority date on or before (inclusive)."},{"name":"include_members","in":"query","required":false,"schema":{"type":"boolean","description":"Include up to 30 member applications per family.","default":false,"title":"Include Members"},"description":"Include up to 30 member applications per family."},{"name":"sort","in":"query","required":false,"schema":{"enum":["latest_status_date","earliest_priority_date","member_count"],"type":"string","description":"`latest_status_date` (default), `earliest_priority_date`, or `member_count`; newest or largest first.","default":"latest_status_date","title":"Sort"},"description":"`latest_status_date` (default), `earliest_priority_date`, or `member_count`; newest or largest first."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Rows per page (1-100).","default":25,"title":"Limit"},"description":"Rows per page (1-100)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"description":"Zero-based row offset for paging.","default":0,"title":"Offset"},"description":"Zero-based row offset for paging."},{"name":"include_total","in":"query","required":false,"schema":{"type":"boolean","description":"Compute the exact total match count.","default":false,"title":"Include Total"},"description":"Compute the exact total match count."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatentFamilyListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/patents/{family_id}":{"get":{"tags":["patents"],"summary":"Get a patent family by id","description":"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.","operationId":"get_patent_family","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"family_id","in":"path","required":true,"schema":{"type":"string","maxLength":64,"pattern":"^[A-Za-z0-9_-]+$","description":"Pav patent family id.","examples":["62662313"],"title":"Family Id"},"description":"Pav patent family id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatentFamilyDetail"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/fda":{"get":{"tags":["fda"],"summary":"List and search FDA records","description":"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 current monthly edition; warning letters and recalls are the published feed.\n\nEvery filter is optional and filters combine with AND. `q` is a case-insensitive substring of the title, description, company name, FDA organization name, or FDA identifier; it does not match synonyms. `company_id` returns only records linked to that company, so an unlinked record (common for warning letters and recalls) never matches it; search the FDA name with `q` as well.\n\nDates: `date_field=document_date` (default) filters on the date FDA issued the record; exclusivities have no issue date, so use `date_field=event_date` for expiries (patent, exclusivity), e.g. `record_type=orange_book_patent&date_field=event_date&date_from=2027-01-01&sort=event_date&direction=asc`.","operationId":"list_fda_records","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Substring of title, description, company or FDA identifier.","examples":["semaglutide"],"title":"Q"},"description":"Substring of title, description, company or FDA identifier."},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"description":"Records linked to any of these Pav company ids. Repeatable.","title":"Company Id"},"description":"Records linked to any of these Pav company ids. Repeatable."},{"name":"record_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["orange_book_product","orange_book_patent","orange_book_exclusivity","purple_book_product","orphan_designation","warning_letter","recall"],"type":"string"}},{"type":"null"}],"description":"Restrict to these record types. Repeatable.","examples":["recall"],"title":"Record Type"},"description":"Restrict to these record types. Repeatable."},{"name":"application_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"description":"Exact FDA application, e.g. `N:209637` (NDA) or `BLA:761508`.","examples":["N:209637"],"title":"Application Key"},"description":"Exact FDA application, e.g. `N:209637` (NDA) or `BLA:761508`."},{"name":"product_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Exact application + product, e.g. `N:209637:001`.","title":"Product Key"},"description":"Exact application + product, e.g. `N:209637:001`."},{"name":"patent_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"Exact Orange Book listed patent number.","title":"Patent Number"},"description":"Exact Orange Book listed patent number."},{"name":"designation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"Exact OOPD orphan designation id.","title":"Designation Id"},"description":"Exact OOPD orphan designation id."},{"name":"date_field","in":"query","required":false,"schema":{"enum":["document_date","event_date"],"type":"string","description":"Which date `date_from` / `date_to` filter: issue or event date.","default":"document_date","title":"Date Field"},"description":"Which date `date_from` / `date_to` filter: issue or event date."},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"On or after this date (inclusive).","title":"Date From"},"description":"On or after this date (inclusive)."},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"On or before this date (inclusive).","title":"Date To"},"description":"On or before this date (inclusive)."},{"name":"sort","in":"query","required":false,"schema":{"enum":["document_date","event_date"],"type":"string","description":"`document_date` (default) or `event_date`; nulls sort last.","default":"document_date","title":"Sort"},"description":"`document_date` (default) or `event_date`; nulls sort last."},{"name":"direction","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"`desc` (default, newest first) or `asc`.","default":"desc","title":"Direction"},"description":"`desc` (default, newest first) or `asc`."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Rows per page (1-100).","default":25,"title":"Limit"},"description":"Rows per page (1-100)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"description":"Zero-based row offset for paging.","default":0,"title":"Offset"},"description":"Zero-based row offset for paging."},{"name":"include_total","in":"query","required":false,"schema":{"type":"boolean","description":"Compute the exact total match count.","default":false,"title":"Include Total"},"description":"Compute the exact total match count."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FdaListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/fda/{record_key}":{"get":{"tags":["fda"],"summary":"Get an FDA record by key","description":"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_id`). Warning-letter and recall keys are durable. Returns `404 not_found` for an unknown key.","operationId":"get_fda_record","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"record_key","in":"path","required":true,"schema":{"type":"string","maxLength":400,"description":"`record_key` from a list response. May contain `/`, `:` and spaces.","examples":["purple_book_product:2026-08:761508:001"],"title":"Record Key"},"description":"`record_key` from a list response. May contain `/`, `:` and spaces."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FdaRecord"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/changes":{"get":{"tags":["changes"],"summary":"List pipeline change events","description":"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=` bounds the start. Retracted changes are hidden unless `include_invalidated=true`.","operationId":"list_changes","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"description":"Filter to these Pav company ids. Repeatable.","examples":[412],"title":"Company Id"},"description":"Filter to these Pav company ids. Repeatable."},{"name":"change_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["insert","update","delete"],"type":"string"}},{"type":"null"}],"description":"Filter by change type: `insert`, `update`, `delete`. Repeatable.","examples":["update"],"title":"Change Type"},"description":"Filter by change type: `insert`, `update`, `delete`. Repeatable."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only changes detected at or after this timestamp (ISO 8601).","examples":["2026-06-01T00:00:00Z"],"title":"Since"},"description":"Only changes detected at or after this timestamp (ISO 8601)."},{"name":"include_invalidated","in":"query","required":false,"schema":{"type":"boolean","description":"Include changes later retracted after a correction.","examples":[false],"default":false,"title":"Include Invalidated"},"description":"Include changes later retracted after a correction."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor from a prior response's `next_cursor`. Preferred over `offset`; wins when both are sent.","title":"Cursor"},"description":"Opaque cursor from a prior response's `next_cursor`. Preferred over `offset`; wins when both are sent."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum rows to return (1-5000).","examples":[50],"default":50,"title":"Limit"},"description":"Maximum rows to return (1-5000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset. Prefer `cursor`, which wins when both are sent.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset. Prefer `cursor`, which wins when both are sent."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/companies/{company_id}/changes":{"get":{"tags":["changes"],"summary":"List a company's change events","description":"Pipeline changes for one company, newest first. Same `cursor`, `next_cursor` and `include_invalidated` behavior as `GET /v1/changes`.","operationId":"list_company_changes","security":[{"EnterpriseApiKey":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"integer","description":"Durable Pav company id.","examples":[412],"title":"Company Id"},"description":"Durable Pav company id."},{"name":"change_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["insert","update","delete"],"type":"string"}},{"type":"null"}],"description":"Filter by change type: `insert`, `update`, `delete`. Repeatable.","examples":["update"],"title":"Change Type"},"description":"Filter by change type: `insert`, `update`, `delete`. Repeatable."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only changes detected at or after this timestamp (ISO 8601).","examples":["2026-06-01T00:00:00Z"],"title":"Since"},"description":"Only changes detected at or after this timestamp (ISO 8601)."},{"name":"include_invalidated","in":"query","required":false,"schema":{"type":"boolean","description":"Include changes later retracted after a correction.","examples":[false],"default":false,"title":"Include Invalidated"},"description":"Include changes later retracted after a correction."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor from a prior response's `next_cursor`. Preferred over `offset`; wins when both are sent.","title":"Cursor"},"description":"Opaque cursor from a prior response's `next_cursor`. Preferred over `offset`; wins when both are sent."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum rows to return (1-5000).","examples":[50],"default":50,"title":"Limit"},"description":"Maximum rows to return (1-5000)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":2000000000,"minimum":0,"description":"Zero-based row offset. Prefer `cursor`.","examples":[0],"default":0,"title":"Offset"},"description":"Zero-based row offset. Prefer `cursor`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeListResponse"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/stats":{"get":{"tags":["stats"],"summary":"Dataset summary statistics","description":"Aggregate counts across the Pav pipeline dataset: total programs and companies, distinct phases/modalities/indications, and program counts grouped by normalized phase and modality.","operationId":"get_stats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}},"401":{"description":"Missing or invalid API key (`unauthorized`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown id or route (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Invalid parameter (`validation_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded (`rate_limited`); honor `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"EnterpriseApiKey":[]}]}}},"components":{"schemas":{"ChangeEvent":{"properties":{"id":{"type":"integer","title":"Id","description":"Change-event identifier.","examples":[90211]},"company_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Id","description":"Pav company identifier the change belongs to.","examples":[412]},"short_name":{"type":"string","title":"Short Name","description":"Slug of the company that owns the changed program.","examples":["pfizer"]},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Company display name.","examples":["Pfizer"]},"drug":{"type":"string","title":"Drug","description":"Drug/asset name of the changed program.","examples":["Danuglipron"]},"indication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indication","description":"Indication of the changed program.","examples":["Type 2 Diabetes"]},"territory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Territory","description":"Territory of the changed program, when disclosed.","examples":["United States"]},"change_type":{"type":"string","title":"Change Type","description":"`insert` (program added), `update` (phase or details changed), or `delete` (program left the company's pipeline).","examples":["update"]},"prev_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prev Phase","description":"Phase before the change (raw label).","examples":["Phase 1"]},"new_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Phase","description":"Phase after the change (raw label).","examples":["Phase 2"]},"invalidated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Invalidated At","description":"When this change was retracted after a correction. Null unless `include_invalidated=true` surfaces a retracted change.","examples":["2026-06-20T04:12:00Z"]},"invalidation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidation Reason","description":"Reason the change was invalidated, if any.","examples":["source correction"]},"detected_at":{"type":"string","format":"date-time","title":"Detected At","description":"When the change was first detected (UTC).","examples":["2026-06-19T04:12:00Z"]}},"type":"object","required":["id","short_name","drug","change_type","detected_at"],"title":"ChangeEvent"},"ChangeListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ChangeEvent"},"type":"array","title":"Data","description":"Page of pipeline change events."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Opaque cursor to fetch the next page; pass it back as `?cursor=`. Null when this page exhausts the feed. Stable under concurrent inserts (unlike `offset`).","examples":["<opaque cursor>"]}},"type":"object","required":["data","pagination"],"title":"ChangeListResponse"},"ClinicalTrial":{"properties":{"nct_id":{"type":"string","title":"Nct Id","description":"ClinicalTrials.gov registry identifier (NCT number).","examples":["NCT04368728"]},"nct_url":{"type":"string","title":"Nct Url","description":"ClinicalTrials.gov URL for the trial record.","examples":["https://clinicaltrials.gov/study/NCT04368728"]},"nct_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nct Phase","description":"Trial phase as reported by ClinicalTrials.gov.","examples":["Phase 3"]},"nct_sponsor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nct Sponsor","description":"Lead sponsor of the trial as reported by ClinicalTrials.gov.","examples":["Pfizer"]},"nct_conditions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nct Conditions","description":"Pipe-delimited conditions/indications studied in the trial.","examples":["COVID-19|SARS-CoV-2 Infection"]},"nct_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nct Status","description":"Overall recruitment/operational status of the trial.","examples":["Completed"]}},"type":"object","required":["nct_id","nct_url"],"title":"ClinicalTrial"},"Company":{"properties":{"company_id":{"type":"integer","title":"Company Id","description":"Durable Pav company identifier.","examples":[412]},"short_name":{"type":"string","title":"Short Name","description":"Company slug, a stable readable identifier.","examples":["pfizer"]},"name":{"type":"string","title":"Name","description":"Company display name.","examples":["Pfizer"]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Headquarters country, when known.","examples":["United States"]},"asset_count":{"type":"integer","title":"Asset Count","description":"Number of pipeline programs Pav tracks for this company.","default":0,"examples":[87]},"last_checked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Checked At","description":"When Pav last read this company's pipeline (UTC).","examples":["2026-06-19T04:12:00Z"]}},"type":"object","required":["company_id","short_name","name"],"title":"Company"},"CompanyListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Company"},"type":"array","title":"Data","description":"Page of company rows."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."}},"type":"object","required":["data","pagination"],"title":"CompanyListResponse"},"Deal":{"properties":{"deal_id":{"type":"string","format":"uuid","title":"Deal Id","description":"Stable Pav deal identifier.","examples":["ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"]},"deal_name":{"type":"string","title":"Deal Name","description":"Deal headline.","examples":["Merck KGaA acquisition of Bio-Techne Corporation"]},"deal_type":{"type":"string","enum":["acquisition","merger","asset_purchase","licensing","collaboration","option","joint_venture","distribution","other"],"title":"Deal Type","description":"Deal classification.","examples":["acquisition"]},"latest_event_type":{"type":"string","enum":["proposed","announced","completed","amended","terminated","update"],"title":"Latest Event Type","description":"Current lifecycle state. `update` means the latest mention changed no lifecycle state.","examples":["completed"]},"latest_event_name":{"type":"string","title":"Latest Event Name","description":"Headline of the latest lifecycle event."},"latest_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Event At","description":"Date of the latest lifecycle event, when stated (UTC)."},"activity_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Activity Date","description":"Latest activity: the latest event's date, else its source's publish date. Default sort key."},"announced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Announced At","description":"Announcement date (UTC)."},"latest_update_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Update At","description":"Most recent update mention (UTC)."},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"Completion date (UTC)."},"summary":{"type":"string","title":"Summary","description":"One-paragraph deal summary."},"companies":{"items":{"$ref":"#/components/schemas/DealCompany"},"type":"array","title":"Companies","description":"Parties linked to Pav companies."},"total_value":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Headline (total) deal value, when stated."},"upfront":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Upfront consideration."},"development_milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Development milestone economics."},"regulatory_milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Regulatory milestone economics."},"commercial_milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Commercial / sales milestone economics."},"source_document_count":{"type":"integer","title":"Source Document Count","description":"Distinct source documents behind the deal."},"event_count":{"type":"integer","title":"Event Count","description":"Lifecycle events recorded for the deal."}},"type":"object","required":["deal_id","deal_name","deal_type","latest_event_type","latest_event_name","summary","source_document_count","event_count"],"title":"Deal"},"DealCompany":{"properties":{"company_id":{"type":"integer","title":"Company Id","description":"Durable Pav company identifier.","examples":[239]},"short_name":{"type":"string","title":"Short Name","description":"Company slug.","examples":["merck_kgaa"]},"name":{"type":"string","title":"Name","description":"Company display name.","examples":["Merck KGaA"]},"roles":{"items":{"type":"string"},"type":"array","title":"Roles","description":"Roles the source documents give this party (e.g. acquirer, licensor).","examples":[["acquirer"]]}},"type":"object","required":["company_id","short_name","name"],"title":"DealCompany"},"DealDetail":{"properties":{"deal_id":{"type":"string","format":"uuid","title":"Deal Id","description":"Stable Pav deal identifier.","examples":["ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"]},"deal_name":{"type":"string","title":"Deal Name","description":"Deal headline.","examples":["Merck KGaA acquisition of Bio-Techne Corporation"]},"deal_type":{"type":"string","enum":["acquisition","merger","asset_purchase","licensing","collaboration","option","joint_venture","distribution","other"],"title":"Deal Type","description":"Deal classification.","examples":["acquisition"]},"latest_event_type":{"type":"string","enum":["proposed","announced","completed","amended","terminated","update"],"title":"Latest Event Type","description":"Current lifecycle state. `update` means the latest mention changed no lifecycle state.","examples":["completed"]},"latest_event_name":{"type":"string","title":"Latest Event Name","description":"Headline of the latest lifecycle event."},"latest_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Event At","description":"Date of the latest lifecycle event, when stated (UTC)."},"activity_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Activity Date","description":"Latest activity: the latest event's date, else its source's publish date. Default sort key."},"announced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Announced At","description":"Announcement date (UTC)."},"latest_update_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Update At","description":"Most recent update mention (UTC)."},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"Completion date (UTC)."},"summary":{"type":"string","title":"Summary","description":"One-paragraph deal summary."},"companies":{"items":{"$ref":"#/components/schemas/DealCompany"},"type":"array","title":"Companies","description":"Parties linked to Pav companies."},"total_value":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Headline (total) deal value, when stated."},"upfront":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Upfront consideration."},"development_milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Development milestone economics."},"regulatory_milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Regulatory milestone economics."},"commercial_milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Commercial / sales milestone economics."},"source_document_count":{"type":"integer","title":"Source Document Count","description":"Distinct source documents behind the deal."},"event_count":{"type":"integer","title":"Event Count","description":"Lifecycle events recorded for the deal."},"terms":{"$ref":"#/components/schemas/DealTerms","description":"Economics and rights across all source documents."},"events":{"items":{"$ref":"#/components/schemas/DealEvent"},"type":"array","title":"Events","description":"Lifecycle events, oldest first."},"source_documents":{"items":{"$ref":"#/components/schemas/DealSourceDocument"},"type":"array","title":"Source Documents","description":"Source documents behind the deal, oldest first."}},"type":"object","required":["deal_id","deal_name","deal_type","latest_event_type","latest_event_name","summary","source_document_count","event_count","terms"],"title":"DealDetail"},"DealEvent":{"properties":{"event_type":{"type":"string","enum":["proposed","announced","completed","amended","terminated","update"],"title":"Event Type","description":"Lifecycle event type."},"event_name":{"type":"string","title":"Event Name","description":"Event headline."},"effective_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Effective At","description":"Event date (UTC day): the source's stated date, else its publication date."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"URL of the document that reported this event."}},"type":"object","required":["event_type","event_name"],"title":"DealEvent"},"DealListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Deal"},"type":"array","title":"Data","description":"Page of deals."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."}},"type":"object","required":["data","pagination"],"title":"DealListResponse"},"DealSourceDocument":{"properties":{"source_vendor":{"type":"string","title":"Source Vendor","description":"Publisher of the source document.","examples":["sec"]},"source_kind":{"type":"string","title":"Source Kind","description":"Document kind.","examples":["sec_filing"]},"source_id":{"type":"string","title":"Source Id","description":"Source-native document id.","examples":["0001999371-26-013429/ex99-1.htm"]},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"Public URL of the document."},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At","description":"Publication time (UTC)."},"observed_at":{"type":"string","format":"date-time","title":"Observed At","description":"When Pav first saw the document (UTC)."}},"type":"object","required":["source_vendor","source_kind","source_id","observed_at"],"title":"DealSourceDocument"},"DealTerms":{"properties":{"headline_value":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Total deal value."},"upfront":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Upfront consideration."},"equity":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Equity stake or investment."},"milestones":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Milestone economics."},"royalties":{"anyOf":[{"$ref":"#/components/schemas/DealValue"},{"type":"null"}],"description":"Royalty economics."},"territories":{"items":{"type":"string"},"type":"array","title":"Territories","description":"Territories covered."},"rights_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rights Summary","description":"Rights granted, in brief."}},"type":"object","title":"DealTerms"},"DealValue":{"properties":{"raw_text":{"type":"string","title":"Raw Text","description":"The term as the source states it.","examples":["total enterprise value of approximately US$11.3 billion"]},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount","description":"Monetary amount in base currency units. Null for percentages or unstated values.","examples":[11300000000.0]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"ISO 4217 code for `amount`.","examples":["USD"]},"percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentage","description":"Percentage value (royalties, equity).","examples":[null]},"not_disclosed":{"type":"boolean","title":"Not Disclosed","description":"True when the source explicitly withholds this term.","default":false},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence","description":"Source sentence supporting the value."}},"type":"object","required":["raw_text"],"title":"DealValue"},"FdaCompany":{"properties":{"company_id":{"type":"integer","title":"Company Id","description":"Durable Pav company identifier.","examples":[5093]},"short_name":{"type":"string","title":"Short Name","description":"Company slug.","examples":["regeneron"]},"name":{"type":"string","title":"Name","description":"Company display name.","examples":["Regeneron Pharmaceuticals"]}},"type":"object","required":["company_id","short_name","name"],"title":"FdaCompany"},"FdaListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FdaRecord"},"type":"array","title":"Data","description":"Page of FDA records."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."}},"type":"object","required":["data","pagination"],"title":"FdaListResponse"},"FdaRecord":{"properties":{"record_key":{"type":"string","title":"Record Key","description":"Pav key for this record in the current FDA edition; pass it to `GET /v1/fda/{record_key}`. Orange Book, Purple Book and orphan designation keys include the edition, so they change when FDA publishes a new one. For a durable handle filter by `application_key`, `product_key`, `patent_number` or `designation_id`.","examples":["purple_book_product:2026-08:761508:001"]},"record_type":{"type":"string","enum":["orange_book_product","orange_book_patent","orange_book_exclusivity","purple_book_product","orphan_designation","warning_letter","recall"],"title":"Record Type","description":"Kind of FDA record.","examples":["purple_book_product"]},"source":{"type":"string","title":"Source","description":"FDA publication the record comes from.","examples":["purple_book"]},"source_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Version","description":"Source edition: `YYYY-MM` for Orange and Purple Book, the load date for orphan designations, null for warning letters and recalls (published continuously).","examples":["2026-08"]},"fda_organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fda Organization Name","description":"Applicant, sponsor or recipient name as FDA spells it.","examples":["Regeneron Pharmaceuticals, Inc."]},"company":{"anyOf":[{"$ref":"#/components/schemas/FdaCompany"},{"type":"null"}],"description":"The Pav company this FDA organization is linked to. Null when unlinked: most Orange Book, Purple Book and orphan records are linked; most warning-letter and recall recipients (compounders, device and food makers) do not."},"application_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Key","description":"FDA application: `N:` (NDA), `A:` (ANDA) or `BLA:` plus the number.","examples":["BLA:761508"]},"product_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Key","description":"Application plus the FDA product number.","examples":["BLA:761508:001"]},"designation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Designation Id","description":"OOPD orphan designation id.","examples":["1186826"]},"patent_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patent Number","description":"Orange Book listed US patent number.","examples":["10022461"]},"title":{"type":"string","title":"Title","description":"Display title: trade name, patent or exclusivity label, subject, or brand.","examples":["GENGLYCOS"]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Ingredient or proper name for products, patents and exclusivities; the designated indication for orphan designations; the subject for warning letters; the product for recalls."},"document_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Document Date","description":"Date FDA issued the record: approval, patent submission, designation, letter issue, or recall. Always null for exclusivities; null for some old products."},"event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Event Date","description":"The date `event_date_type` names, e.g. a patent expiry."},"event_date_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Date Type","description":"Meaning of `event_date`: `approval`, `patent_expiry`, `exclusivity_expiry`, `designation`, `issued`, `posted`, or `recall`.","examples":["patent_expiry"]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Source status: marketing status for products (`RX`, `OTC`, `DISCN`, ...), `listed`/`delisted` for patents, the exclusivity code for exclusivities, the designation status, `issued`/`closed` for warning letters, `active`/`terminated` for recalls.","examples":["RX"]},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"Official FDA page for the record. Null for Orange and Purple Book rows."},"details":{"$ref":"#/components/schemas/FdaRecordDetails","description":"Record-type specific source fields."}},"type":"object","required":["record_key","record_type","source","title"],"title":"FdaRecord"},"FdaRecordDetails":{"properties":{"ingredient":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingredient","description":"Orange Book active ingredient(s) as FDA lists them.","examples":["SEMAGLUTIDE"]},"strength":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strength","description":"Orange Book / Purple Book strength.","examples":["300MG/5ML (60MG/ML)"]},"dosage_route":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dosage Route","description":"Orange Book dosage form and route, `FORM;ROUTE`.","examples":["TABLET;ORAL"]},"dosage_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dosage Form","description":"Purple Book dosage form.","examples":["Injection"]},"route":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route","description":"Purple Book route of administration.","examples":["Intravenous"]},"therapeutic_equivalence_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Therapeutic Equivalence Code","description":"Orange Book therapeutic-equivalence (TE) code; set only for multisource products.","examples":["AB1"]},"reference_listed_drug":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reference Listed Drug","description":"Orange Book: the product is a reference listed drug (RLD)."},"reference_standard":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reference Standard","description":"Orange Book: the product is the reference standard (RS)."},"patent_use_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patent Use Code","description":"Orange Book patent use code (method-of-use claim), when listed.","examples":["U-4597"]},"pediatric_extension":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pediatric Extension","description":"Orange Book patent: the expiry includes pediatric exclusivity."},"drug_substance_claim":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Drug Substance Claim","description":"Orange Book patent claims the drug substance. Null when not flagged."},"drug_product_claim":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Drug Product Claim","description":"Orange Book patent claims the drug product. Null when not flagged."},"license_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License Type","description":"Purple Book pathway: `351(a)` (reference product) or `351(k)` (biosimilar).","examples":["351(a)"]},"licensure":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Licensure","description":"Purple Book licensure status.","examples":["Licensed"]},"license_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License Number","description":"Purple Book US license number of the holder.","examples":["1760"]},"orphan_exclusivity_expiry":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Orphan Exclusivity Expiry","description":"Purple Book orphan exclusivity expiry."},"reference_product_exclusivity_expiry":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Reference Product Exclusivity Expiry","description":"Purple Book 12-year reference product exclusivity expiry."},"generic_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generic Name","description":"Orphan designation: generic name as the sponsor filed it.","examples":["inosine pranobex"]},"marketing_approval_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Marketing Approval Date","description":"Orphan designation: marketing approval date, once approved."},"exclusivity_end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Exclusivity End Date","description":"Orphan designation: orphan exclusivity end date."},"approved_labeled_indication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved Labeled Indication","description":"Orphan designation: the approved labeled indication."},"protected_indication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protected Indication","description":"Orphan designation: the exclusivity-protected indication."},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Recall reason category.","examples":["Mislabeling"]},"reason_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Description","description":"Recall reason as FDA describes it."},"product_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Product Types","description":"Recall product types. Food-only recalls are excluded from this feed.","examples":[["Drugs"]]},"issuing_office":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuing Office","description":"Warning letter issuing office.","examples":["Center for Drug Evaluation and Research (CDER)"]},"fda_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fda Reference Id","description":"Warning letter FDA reference number.","examples":["738238"]},"closeout_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Closeout Date","description":"Warning letter close-out date, once FDA closed it out."}},"type":"object","title":"FdaRecordDetails","description":"Source fields for one record. Each field applies to the record types named in it."},"IndicationTerm":{"properties":{"ontology":{"type":"string","title":"Ontology","description":"Ontology of the indication term (e.g. MONDO).","examples":["MONDO"]},"term_id":{"type":"string","title":"Term Id","description":"Ontology term identifier.","examples":["MONDO:0005148"]},"term_label":{"type":"string","title":"Term Label","description":"Human-readable ontology term label.","examples":["type 2 diabetes mellitus"]},"source_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Text","description":"Indication text the term was mapped from.","examples":["Type 2 Diabetes"]}},"type":"object","required":["ontology","term_id","term_label"],"title":"IndicationTerm"},"Pagination":{"properties":{"limit":{"type":"integer","title":"Limit","description":"Maximum number of rows returned for this request.","examples":[100]},"offset":{"type":"integer","title":"Offset","description":"Zero-based row offset applied before returning results.","examples":[0]},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total","description":"Total matching rows across all pages. Null on relevance-ranked search responses and on listings requested without `include_total`.","examples":[590355]}},"type":"object","required":["limit","offset"],"title":"Pagination"},"PatentCompany":{"properties":{"company_id":{"type":"integer","title":"Company Id","description":"Durable Pav company identifier.","examples":[137]},"short_name":{"type":"string","title":"Short Name","description":"Company slug.","examples":["johnson_and_johnson"]},"name":{"type":"string","title":"Name","description":"Company display name.","examples":["Johnson & Johnson"]}},"type":"object","required":["company_id","short_name","name"],"title":"PatentCompany"},"PatentFamily":{"properties":{"family_id":{"type":"string","title":"Family Id","description":"Pav patent family identifier.","examples":["62662313"]},"representative_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Representative Title","description":"Title of the family's representative member.","examples":["GLUCAGON LIKE PEPTIDE 1 (GLP-1) FUSION PEPTIDE ... CONJUGATES AND USES THEREOF"]},"member_count":{"type":"integer","title":"Member Count","description":"Applications in the family.","examples":[2]},"granted_count":{"type":"integer","title":"Granted Count","description":"Granted members.","examples":[1]},"pending_count":{"type":"integer","title":"Pending Count","description":"Pending members.","examples":[0]},"earliest_filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Earliest Filing Date","description":"Earliest member filing."},"earliest_priority_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Earliest Priority Date","description":"Earliest priority date."},"latest_grant_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Grant Date","description":"Most recent grant."},"latest_status_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Status Date","description":"Most recent status change on any member. Default sort key."},"has_live_member":{"type":"boolean","title":"Has Live Member","description":"True when any member is pending or in force."},"owner_names":{"items":{"type":"string"},"type":"array","title":"Owner Names","description":"Recorded owners of the live members. Empty for a lapsed family."},"owner_is_split":{"type":"boolean","title":"Owner Is Split","description":"True when live members have different owners."},"companies":{"items":{"$ref":"#/components/schemas/PatentCompany"},"type":"array","title":"Companies","description":"Owners linked to Pav companies. About a quarter of families map to a company, so an empty list does not mean the company holds no patents."},"members":{"anyOf":[{"items":{"$ref":"#/components/schemas/PatentFamilyMember"},"type":"array"},{"type":"null"}],"title":"Members","description":"Member applications, newest filed first. Present with `include_members=true`."}},"type":"object","required":["family_id","member_count","granted_count","pending_count","has_live_member","owner_is_split"],"title":"PatentFamily"},"PatentFamilyDetail":{"properties":{"family_id":{"type":"string","title":"Family Id","description":"Pav patent family identifier.","examples":["62662313"]},"representative_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Representative Title","description":"Representative title."},"member_count":{"type":"integer","title":"Member Count","description":"Applications in the family."},"granted_count":{"type":"integer","title":"Granted Count","description":"Granted members."},"pending_count":{"type":"integer","title":"Pending Count","description":"Pending members."},"earliest_priority_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Earliest Priority Date","description":"Earliest priority date."},"earliest_filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Earliest Filing Date","description":"Earliest member filing."},"latest_grant_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Grant Date","description":"Most recent grant."},"latest_status_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Status Date","description":"Most recent status change."},"has_live_member":{"type":"boolean","title":"Has Live Member","description":"True when any member is pending or in force."},"owner_names":{"items":{"type":"string"},"type":"array","title":"Owner Names","description":"Owners of the live members; for a lapsed family, owners across all members."},"owner_source":{"type":"string","enum":["live_members","all_members","none"],"title":"Owner Source","description":"Which members `owner_names` was read from."},"owner_is_split":{"type":"boolean","title":"Owner Is Split","description":"True when live members have different owners."},"companies":{"items":{"$ref":"#/components/schemas/PatentCompany"},"type":"array","title":"Companies","description":"Owners linked to Pav companies."},"has_open_security_interest":{"type":"boolean","title":"Has Open Security Interest","description":"True when any member carries an open security interest."},"latest_maintenance_fee_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Maintenance Fee Date","description":"Most recent maintenance-fee payment on any member."},"statutory_term_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Statutory Term Start","description":"Earliest nonprovisional filing the family claims (35 USC 154(a)(2)). Null when an ancestor's filing date is unknown."},"statutory_term_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Statutory Term End","description":"`statutory_term_start` plus 20 years. Term adjustments and extensions are not applied."},"cpc_codes":{"items":{"type":"string"},"type":"array","title":"Cpc Codes","description":"Most-used CPC codes across members."},"members":{"items":{"$ref":"#/components/schemas/PatentFamilyDetailMember"},"type":"array","title":"Members","description":"Member applications."},"ownership":{"items":{"$ref":"#/components/schemas/PatentOwnershipEvent"},"type":"array","title":"Ownership","description":"Recorded conveyances, newest first."},"events":{"items":{"$ref":"#/components/schemas/PatentProsecutionEvent"},"type":"array","title":"Events","description":"Prosecution and maintenance events, newest first (capped)."},"events_total":{"type":"integer","title":"Events Total","description":"Uncapped count of `events`."}},"type":"object","required":["family_id","member_count","granted_count","pending_count","has_live_member","owner_source","owner_is_split","has_open_security_interest","events_total"],"title":"PatentFamilyDetail"},"PatentFamilyDetailMember":{"properties":{"application_number":{"type":"string","title":"Application Number","description":"USPTO application number.","examples":["17076912"]},"patent_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patent Number","description":"Granted patent number; null until granted."},"publication_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publication Number","description":"Pre-grant publication number."},"role":{"type":"string","title":"Role","description":"Member's place in the family (root, continuation, ...)."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Application title."},"application_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Type","description":"USPTO application type."},"filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Filing Date","description":"Filing date."},"grant_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Grant Date","description":"Grant date."},"status_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Description","description":"Current USPTO status."},"status_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Status Date","description":"Date of the current status."},"is_dead":{"type":"boolean","title":"Is Dead","description":"True when the application is abandoned or expired."},"cpc_codes":{"items":{"type":"string"},"type":"array","title":"Cpc Codes","description":"CPC classification codes."},"status_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Code","description":"USPTO status code."},"depth":{"type":"integer","title":"Depth","description":"Distance from the family root."},"owner_names":{"items":{"type":"string"},"type":"array","title":"Owner Names","description":"Member's current owners."},"has_open_security_interest":{"type":"boolean","title":"Has Open Security Interest","description":"True when an open security interest (lien) is recorded on this member."}},"type":"object","required":["application_number","role","is_dead","depth","has_open_security_interest"],"title":"PatentFamilyDetailMember"},"PatentFamilyListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PatentFamily"},"type":"array","title":"Data","description":"Page of patent families."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."}},"type":"object","required":["data","pagination"],"title":"PatentFamilyListResponse"},"PatentFamilyMember":{"properties":{"application_number":{"type":"string","title":"Application Number","description":"USPTO application number.","examples":["17076912"]},"patent_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patent Number","description":"Granted patent number; null until granted."},"publication_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publication Number","description":"Pre-grant publication number."},"role":{"type":"string","title":"Role","description":"Member's place in the family (root, continuation, ...)."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Application title."},"application_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Type","description":"USPTO application type."},"filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Filing Date","description":"Filing date."},"grant_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Grant Date","description":"Grant date."},"status_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Description","description":"Current USPTO status."},"status_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Status Date","description":"Date of the current status."},"is_dead":{"type":"boolean","title":"Is Dead","description":"True when the application is abandoned or expired."},"cpc_codes":{"items":{"type":"string"},"type":"array","title":"Cpc Codes","description":"CPC classification codes."}},"type":"object","required":["application_number","role","is_dead"],"title":"PatentFamilyMember"},"PatentOwnershipEvent":{"properties":{"recorded_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Recorded Date","description":"USPTO recordation date."},"conveyance_kind":{"type":"string","title":"Conveyance Kind","description":"Conveyance type (assignment, security interest, ...)."},"conveyance_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conveyance Text","description":"Conveyance as recorded."},"assignors":{"items":{"type":"string"},"type":"array","title":"Assignors","description":"Conveying parties."},"assignees":{"items":{"type":"string"},"type":"array","title":"Assignees","description":"Receiving parties."},"application_numbers":{"items":{"type":"string"},"type":"array","title":"Application Numbers","description":"Members the conveyance was recorded on."}},"type":"object","required":["conveyance_kind"],"title":"PatentOwnershipEvent"},"PatentProsecutionEvent":{"properties":{"event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Event Date","description":"Event date."},"application_number":{"type":"string","title":"Application Number","description":"Member application number."},"patent_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patent Number","description":"Member patent number, if granted."},"event_code":{"type":"string","title":"Event Code","description":"USPTO event code."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Event description."}},"type":"object","required":["application_number","event_code"],"title":"PatentProsecutionEvent"},"PrimaryOutcome":{"properties":{"measure":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measure","description":"The trial's primary endpoint measure (what is being assessed).","examples":["Progression-Free Survival (PFS)"]},"time_frame":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Frame","description":"Time frame over which the primary outcome is measured.","examples":["Year 3"]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Free-text description/definition of the primary outcome.","examples":["Patients are considered a failure if they die, progress, or relapse."]}},"type":"object","title":"PrimaryOutcome"},"Program":{"properties":{"id":{"type":"integer","title":"Id","description":"Durable Pav program identifier. Stable over time and kept when a program is discontinued, so a stored id keeps working.","examples":[18342]},"status":{"type":"string","title":"Status","description":"Lifecycle state of the program: `active` while the company still publishes it, or `discontinued` once it drops off the pipeline. List and search endpoints return only `active` programs; a single-program lookup by id still returns a `discontinued` one.","default":"active","examples":["active"]},"company_id":{"type":"integer","title":"Company Id","description":"Pav company identifier that owns this program.","examples":[412]},"short_name":{"type":"string","title":"Short Name","description":"Company slug, a stable readable identifier.","examples":["pfizer"]},"company":{"type":"string","title":"Company","description":"Display name of the company that owns this program.","examples":["Pfizer"]},"drug":{"type":"string","title":"Drug","description":"Drug or asset name for the program.","examples":["Danuglipron"]},"indication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indication","description":"Indication the program targets, as published by the company.","examples":["Type 2 Diabetes"]},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Development phase as published by the company (raw label).","examples":["Phase 2"]},"phase_norm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase Norm","description":"Phase normalized to Pav's phase vocabulary (e.g. `Phase 2`).","examples":["Phase 2"]},"modality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modality","description":"Drug modality as published by the company (raw label).","examples":["Small molecule"]},"modality_norm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modality Norm","description":"Modality normalized to Pav's modality vocabulary. Null when the modality is not known.","examples":["small_molecule"]},"target":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target","description":"Molecular target of the asset. Coverage is partial — many programs have no published target and this field is null for them.","examples":["GLP-1R"]},"mechanism_of_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mechanism Of Action","description":"Mechanism of action for the asset.","examples":["GLP-1 receptor agonist"]},"territory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Territory","description":"Territory/region the program applies to, when disclosed.","examples":["United States"]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Free-text program description, when published.","examples":["Oral GLP-1 receptor agonist for type 2 diabetes and obesity."]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Additional program notes from the source.","examples":["Phase 2b dose-finding study ongoing."]},"partners":{"items":{},"type":"array","title":"Partners","description":"Collaboration/partnership entries associated with the program."},"clinical_trials":{"items":{"$ref":"#/components/schemas/ClinicalTrial"},"type":"array","title":"Clinical Trials","description":"Clinical trials linked to this program."},"indication_terms":{"items":{"$ref":"#/components/schemas/IndicationTerm"},"type":"array","title":"Indication Terms","description":"Ontology (MONDO) terms mapped from the program's indication."},"target_terms":{"items":{"$ref":"#/components/schemas/TargetTerm"},"type":"array","title":"Target Terms","description":"Ontology (NCIT/HGNC) terms mapped from the program's target."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"URL of the company page the program was read from.","examples":["https://www.pfizer.com/science/drug-product-pipeline"]},"source_checked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Source Checked At","description":"When Pav last read the source page (UTC).","examples":["2026-06-19T04:12:00Z"]}},"type":"object","required":["id","company_id","short_name","company","drug"],"title":"Program"},"ProgramListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Program"},"type":"array","title":"Data","description":"Page of program rows."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."}},"type":"object","required":["data","pagination"],"title":"ProgramListResponse"},"ProgramSortKey":{"type":"string","enum":["company","drug","indication","target","phase","modality","source_checked_at"],"title":"ProgramSortKey"},"ProgramSuggestion":{"properties":{"id":{"type":"integer","title":"Id","description":"Durable Program id.","examples":[6606]},"company":{"type":"string","title":"Company","description":"Company name.","examples":["Pacira BioSciences"]},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name","description":"Company slug.","examples":["pacira_biosciences"]},"company_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Id","description":"Stable company id — send back as a `company_id` filter.","examples":[816]},"drug":{"type":"string","title":"Drug","description":"Program / asset name.","examples":["PCRX-2002"]},"indication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indication","description":"Indication.","examples":["Post-Surgical Pain"]},"target":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target","description":"Molecular target.","examples":["NaV1.8"]},"phase_norm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase Norm","description":"Normalized development phase.","examples":["Phase 2"]},"modality_norm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modality Norm","description":"Normalized modality.","examples":["small_molecule"]}},"type":"object","required":["id","company","drug"],"title":"ProgramSuggestion","description":"One search-as-you-type suggestion: a concrete program, not a facet value."},"SimilarProgramsResponse":{"properties":{"program_id":{"type":"integer","title":"Program Id","description":"The program the similar set was computed for.","examples":[18342]},"data":{"items":{"$ref":"#/components/schemas/Program"},"type":"array","title":"Data","description":"Programs most similar to the source program, ranked by similarity."}},"type":"object","required":["program_id","data"],"title":"SimilarProgramsResponse"},"SortDirection":{"type":"string","enum":["asc","desc"],"title":"SortDirection"},"SponsorRef":{"properties":{"name":{"type":"string","title":"Name","description":"Sponsor organization name exactly as recorded on ClinicalTrials.gov.","examples":["BioNTech SE"]},"role":{"type":"string","title":"Role","description":"Sponsor role on the trial: `lead_sponsor`, `collaborator`, or `owner`.","examples":["lead_sponsor"]},"company_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Id","description":"Pav company identifier this sponsor is linked to. Null when the sponsor is not a tracked company.","examples":[127]},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name","description":"Slug of the Pav company this organization is linked to, when linked.","examples":["biontech"]}},"type":"object","required":["name","role"],"title":"SponsorRef"},"Stats":{"properties":{"assets":{"type":"integer","title":"Assets","description":"Total number of pipeline programs tracked.","examples":[72690]},"companies":{"type":"integer","title":"Companies","description":"Total number of companies tracked.","examples":[8360]},"distinct_phases":{"type":"integer","title":"Distinct Phases","description":"Count of distinct normalized phases present.","examples":[7]},"distinct_modalities":{"type":"integer","title":"Distinct Modalities","description":"Count of distinct normalized modalities present.","examples":[24]},"distinct_indications":{"type":"integer","title":"Distinct Indications","description":"Count of distinct indications present.","examples":[4120]},"by_phase":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Phase","description":"Program counts grouped by normalized phase.","examples":[{"Approved":1701,"Phase 1":7315,"Phase 2":6890,"Phase 3":4954}]},"by_modality":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Modality","description":"Program counts grouped by normalized modality.","examples":[{"antibody":9821,"small_molecule":21044}]}},"type":"object","required":["assets","companies","distinct_phases","distinct_modalities","distinct_indications","by_phase","by_modality"],"title":"Stats"},"TargetTerm":{"properties":{"ontology":{"type":"string","title":"Ontology","description":"Ontology of the target term (NCIT or HGNC).","examples":["NCIT","HGNC"]},"term_id":{"type":"string","title":"Term Id","description":"Ontology term identifier.","examples":["NCIT:C1110","hgnc:9602"]},"term_label":{"type":"string","title":"Term Label","description":"Human-readable ontology term label.","examples":["Ganglioside GD2"]},"source_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Text","description":"Target text the term was mapped from.","examples":["GD2"]}},"type":"object","required":["ontology","term_id","term_label"],"title":"TargetTerm"},"Trial":{"properties":{"nct_id":{"type":"string","title":"Nct Id","description":"ClinicalTrials.gov registry identifier (NCT number).","examples":["NCT04368728"]},"nct_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nct Url","description":"ClinicalTrials.gov URL for the trial record.","examples":["https://clinicaltrials.gov/study/NCT04368728"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Official or brief title of the trial.","examples":["A Study of a Vaccine to Prevent COVID-19"]},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Trial phase as reported by ClinicalTrials.gov.","examples":["Phase 3"]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Overall recruitment/operational status of the trial.","examples":["Completed"]},"sponsor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor","description":"Lead sponsor of the trial.","examples":["Pfizer"]},"study_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Study Type","description":"Study type (e.g. Interventional, Observational).","examples":["Interventional"]},"conditions":{"items":{"type":"string"},"type":"array","title":"Conditions","description":"Conditions/indications studied in the trial.","examples":[["COVID-19","SARS-CoV-2 Infection"]]},"enrollment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrollment Count","description":"Planned or actual participant enrollment.","examples":[43998]},"program_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Program Count","description":"Number of Pav programs linked to this trial.","examples":[2]},"company_short_names":{"items":{"type":"string"},"type":"array","title":"Company Short Names","description":"Slugs of companies whose Pav programs are linked to this trial. For sponsor-based links as well, see `company_ids` and `sponsors`.","examples":[["pfizer","biontech"]]},"lead_sponsor":{"anyOf":[{"$ref":"#/components/schemas/SponsorRef"},{"type":"null"}],"description":"Lead sponsor as recorded on ClinicalTrials.gov. Null when the registry record names no sponsor organization (e.g. some pre-2016 records)."},"collaborators":{"items":{"$ref":"#/components/schemas/SponsorRef"},"type":"array","title":"Collaborators","description":"Collaborator sponsors as recorded on ClinicalTrials.gov."},"sponsors":{"items":{"$ref":"#/components/schemas/SponsorRef"},"type":"array","title":"Sponsors","description":"All sponsors (lead, collaborators, owners), lead sponsor first."},"company_ids":{"items":{"type":"integer"},"type":"array","title":"Company Ids","description":"Pav company ids linked to this trial as a sponsor or through their programs (deduplicated, sorted). Use them to join trials to companies and programs.","examples":[[127,506]]},"programs":{"items":{"$ref":"#/components/schemas/TrialProgram"},"type":"array","title":"Programs","description":"Pav programs linked to this trial."},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Trial start date as reported by ClinicalTrials.gov.","examples":["2020-04-29"]},"last_update_post_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Update Post Date","description":"Date the trial record was last updated on ClinicalTrials.gov.","examples":["2023-08-15"]},"primary_completion_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Completion Date","description":"Primary completion date as reported by ClinicalTrials.gov — the date the last participant was examined or received an intervention for primary-outcome data collection. A key resolution date.","examples":["2012-06-01"]},"completion_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Date","description":"Study completion date as reported by ClinicalTrials.gov.","examples":["2013-03-01"]},"results_first_post_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Results First Post Date","description":"Date results were first posted on ClinicalTrials.gov. Null until the trial has posted results.","examples":["2016-08-04"]},"why_stopped":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why Stopped","description":"Free-text reason the trial stopped early, as reported by ClinicalTrials.gov. Null for trials that did not stop early.","examples":["Slow enrollment"]},"primary_outcomes":{"items":{"$ref":"#/components/schemas/PrimaryOutcome"},"type":"array","title":"Primary Outcomes","description":"The trial's primary outcome measures (primary endpoints) as reported by ClinicalTrials.gov."}},"type":"object","required":["nct_id"],"title":"Trial"},"TrialLinkVia":{"type":"string","enum":["program","sponsor","any"],"title":"TrialLinkVia"},"TrialListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Trial"},"type":"array","title":"Data","description":"Page of clinical-trial rows."},"pagination":{"$ref":"#/components/schemas/Pagination","description":"Pagination metadata for this page."}},"type":"object","required":["data","pagination"],"title":"TrialListResponse"},"TrialProgram":{"properties":{"program_id":{"type":"integer","title":"Program Id","description":"Durable Pav program identifier linked to this trial.","examples":[1027]},"short_name":{"type":"string","title":"Short Name","description":"Slug of the company that owns the linked program.","examples":["biontech"]},"company_id":{"type":"integer","title":"Company Id","description":"Pav company identifier that owns the linked program.","examples":[127]},"drug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Drug","description":"Drug/asset name of the linked program.","examples":["BNT162b2"]},"indication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indication","description":"Indication the linked program targets.","examples":["COVID-19"]}},"type":"object","required":["program_id","short_name","company_id"],"title":"TrialProgram"},"TrialSortKey":{"type":"string","enum":["start_date","last_update","enrollment","nct_id"],"title":"TrialSortKey"},"ErrorEnvelope":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody","description":"Error detail. Present only on 4xx/5xx responses."}},"required":["error"],"title":"ErrorEnvelope","type":"object"},"ErrorBody":{"properties":{"code":{"description":"Stable, machine-readable error code (e.g. `unauthorized`, `not_found`, `validation_error`, `error`).","examples":["not_found"],"title":"Code","type":"string"},"message":{"description":"Human-readable explanation of the error.","examples":["program 999999 not found"],"title":"Message","type":"string"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Correlation id echoed in the `X-Request-ID` response header. Quote it when contacting Pav support about a failed request.","examples":["3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"],"title":"Request Id"}},"required":["code","message"],"title":"ErrorBody","type":"object"}},"securitySchemes":{"EnterpriseApiKey":{"type":"http","description":"Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer <api_key>.","scheme":"bearer","bearerFormat":"Pav API key"}}},"tags":[{"name":"programs","description":"Search and filter drug pipeline assets by company, indication, target, modality, phase, or free text. Includes get-by-id, similar-programs, and facet autocomplete."},{"name":"companies","description":"Tracked biopharma companies and their pipeline ownership. List a company's programs and change history."},{"name":"trials","description":"Search clinical trials — ClinicalTrials.gov records plus Pav program/company links. Relevance-ranked search when `q=` is set; filtered browse otherwise."},{"name":"deals","description":"Biopharma deals (M&A, licensing, collaborations, options, joint ventures) from SEC filings and press releases, with lifecycle state, headline economics, and source documents."},{"name":"patents","description":"US patent families from USPTO with owners linked to Pav companies, member applications, ownership history, and statutory term."},{"name":"fda","description":"FDA records with applicants linked to Pav companies: Orange Book products, patents and exclusivities, Purple Book biologics, orphan designations, warning letters, and recalls."},{"name":"changes","description":"Detected pipeline movement events per company — added and removed assets and phase changes — with before/after phase and detection time."},{"name":"stats","description":"High-level dataset counts and facet coverage."}],"x-pav-api-version":"v1"}