Skip to main content
GET
Get a program by id

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

Durable Pav program id.

Example:

18342

Response

Successful Response

id
integer
required

Durable Pav program identifier. Stable over time and kept when a program is discontinued, so a stored id keeps working.

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

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.

Example:

"active"

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 normalized to Pav's phase vocabulary (e.g. Phase 2).

Example:

"Phase 2"

modality
string | null

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

Example:

"Small molecule"

modality_norm
string | null

Modality normalized to Pav's modality vocabulary. Null when the modality is not known.

Example:

"small_molecule"

target
string | null

Molecular target of the asset. Coverage is partial — many programs have no published target and this field is null for them.

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[]

Collaboration/partnership entries associated with the program.

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"