Quickstart

1. Create an API key

Sign in at app.pav.bio and open Settings → Developer. Create a personal or organization key and copy the secret. It is shown once.

export PAV_API_KEY="<your_api_key>"

2. Make your first request

Every request needs the key in the Authorization header. This call searches programs for oral GLP-1 agonists in obesity.

curl -G https://api.pav.bio/v1/programs \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "q=oral GLP-1 obesity" \
  --data-urlencode "limit=3"

import os
import requests

resp = requests.get(
    "https://api.pav.bio/v1/programs",
    headers={"Authorization": f"Bearer {os.environ['PAV_API_KEY']}"},
    params={"q": "oral GLP-1 obesity", "limit": 3},
)
resp.raise_for_status()
for program in resp.json()["data"]:
    print(program["company"], "|", program["drug"], "|", program["phase_norm"])

const params = new URLSearchParams({ q: "oral GLP-1 obesity", limit: "3" });
const resp = await fetch(`https://api.pav.bio/v1/programs?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PAV_API_KEY}` },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const { data } = await resp.json();
for (const program of data) {
  console.log(program.company, "|", program.drug, "|", program.phase_norm);
}

3. Read the response

List endpoints return a data array and a pagination block. Search results are ordered best match first.

Example response (trimmed)

{
  "data": [
    {
      "id": 33544,
      "company_id": 671,
      "company": "Schrödinger",
      "drug": "GSBR-1290",
      "indication": "Metabolic (Obesity)",
      "phase_norm": "Phase 3",
      "modality_norm": "small_molecule",
      "target": "GLP-1R Selective",
      "mechanism_of_action": "Oral small-molecule selective GLP-1R agonist (beta-arrestin-biased)",
      "partners": ["Structure Therapeutics"],
      "source_url": "https://www.schrodinger.com/pipeline/"
    }
  ],
  "pagination": { "limit": 3, "offset": 0 }
}

Fields with no value are omitted from the JSON rather than returned as null. Check for a key before reading it.

4. Try more datasets

Find a company and list its Phase 3 programs

# Resolve the name to a company_id (Eli Lilly is 218)
curl -G https://api.pav.bio/v1/companies \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "q=Eli Lilly" --data-urlencode "limit=3"

# List that company's Phase 3 programs
curl -G https://api.pav.bio/v1/companies/218/programs \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "phase=Phase 3" --data-urlencode "limit=5"

Largest deals by headline value

curl -G https://api.pav.bio/v1/deals \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "min_value_usd=1000000000" \
  --data-urlencode "sort=headline_value" \
  --data-urlencode "limit=5"

Recruiting Phase 3 obesity trials

curl -G https://api.pav.bio/v1/trials \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "q=obesity" \
  --data-urlencode "phase=Phase 3" \
  --data-urlencode "status=Recruiting" \
  --data-urlencode "limit=5"

Live patent families mentioning tirzepatide

curl -G https://api.pav.bio/v1/patents \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "q=tirzepatide" \
  --data-urlencode "state=live" \
  --data-urlencode "limit=5"

Latest pipeline phase changes

curl -G https://api.pav.bio/v1/changes \
  -H "Authorization: Bearer $PAV_API_KEY" \
  --data-urlencode "change_type=update" \
  --data-urlencode "limit=10"

Datasets

What each dataset contains, its key fields and common queries.

MCP server

Give an agent the same data as tools.

Search and filters

How q and filters combine, and which values filters accept.

Guides

End-to-end workflows: landscapes, deals, patents, monitoring.

Get started

Datasets

Working with the API

Integrations

Guides

1. Create an API key

2. Make your first request

3. Read the response

4. Try more datasets

Next

Datasets

MCP server

Search and filters

Guides

​1. Create an API key

​2. Make your first request

​3. Read the response

​4. Try more datasets

​Next

Datasets

MCP server

Search and filters

Guides

1. Create an API key

2. Make your first request

3. Read the response

4. Try more datasets

Next