Skip to main content
GET
Get a program

Authorizations

Authorization
string
header
required

Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer <api_key>.

Path Parameters

program_id
integer
required

Program id.

Example:

18342

Response

Successful Response

program_id
integer
required

Program id. Stable; kept when a program is discontinued.

Example:

18342

company_id
integer
required

Pav company identifier that owns this program.

Example:

412

short_name
string
required

Company slug, a stable readable identifier.

Example:

"pfizer"

company
string
required

Display name of the company that owns this program.

Example:

"Pfizer"

drug
string
required

Drug or asset name for the program.

Example:

"Danuglipron"

status
string
default:active

active, inactive (known only from trials, all closed) or discontinued. An approved drug stays active after it leaves the company's pipeline page.

Example:

"active"

discontinued_at
string<date-time> | null

When a discontinued program stopped; null otherwise.

Example:

null

basis
enum<string>
default:company_pipeline

How Pav knows of the program: company_pipeline, regulatory_approval (an approved use the pipeline does not list; source_url is the label) or clinical_trial_registry.

Available options:
company_pipeline,
regulatory_approval,
clinical_trial_registry
Example:

"company_pipeline"

drug_id
integer | null

Drug id shared by every company's programs of the same product. Null when the program names no product.

Example:

5120

aliases
string[]

Other names of the drug: INN, codes, brands.

Example:
indication
string | null

Indication the program targets, as published by the company.

Example:

"Type 2 Diabetes"

phase
string | null

Development phase as published by the company (raw label).

Example:

"Phase 2"

phase_norm
string | null

Phase in Pav's vocabulary: the developer's phase for this indication, raised to Approved by a US or EU approval that covers it. Without one, the most advanced registered trial of the drug in the indication, then a dated public source. A trial never raises a developer's phase.

Example:

"Phase 2"

modality
string | null

Drug modality as published by the company (raw label).

Example:

"Small molecule"

modality_norm
string | null

Modality in Pav's vocabulary; one per drug.

Example:

"small_molecule"

modality_subclass
string | null

Nucleic-acid class: sirna, mrna, sarna, rna_editing, aso, aptamer.

Example:

"sirna"

modality_formats
string[]

Formats: bispecific (includes tri- and multispecifics), antibody_drug_conjugate, peptide_drug_conjugate, antibody_oligonucleotide_conjugate, antibody_peptide_conjugate.

Example:
target
string | null

Molecular target as published. Null when none is published.

Example:

"GLP-1R"

mechanism_of_action
string | null

Mechanism of action for the asset.

Example:

"GLP-1 receptor agonist"

territory
string | null

Territory/region the program applies to, when disclosed.

Example:

"United States"

description
string | null

Free-text program description, when published.

Example:

"Oral GLP-1 receptor agonist for type 2 diabetes and obesity."

notes
string | null

Additional program notes from the source.

Example:

"Phase 2b dose-finding study ongoing."

partners
any[]

Partners the company lists; if none, other companies holding the same drug.

Example:
clinical_trials
ClinicalTrial · object[]

Clinical trials linked to this program.

indication_terms
IndicationTerm · object[]

Ontology (MONDO) terms mapped from the program's indication.

target_terms
TargetTerm · object[]

Ontology (NCIT/HGNC) terms mapped from the program's target.

source_url
string | null

URL of the company page the program was read from.

Example:

"https://www.pfizer.com/science/drug-product-pipeline"

source_checked_at
string<date-time> | null

When Pav last read the source page (UTC).

Example:

"2026-06-19T04:12:00Z"

last_updated
string<date-time> | null

When the program's latest event happened (a phase change, readout, filing, approval). from/to and sort=last_updated use it.

Example:

"2026-09-12T00:00:00Z"