curl --request GET \
--url https://api.pav.bio/v1/deals/{deal_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pav.bio/v1/deals/{deal_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pav.bio/v1/deals/{deal_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pav.bio/v1/deals/{deal_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pav.bio/v1/deals/{deal_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pav.bio/v1/deals/{deal_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pav.bio/v1/deals/{deal_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"deal_id": "ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210",
"deal_name": "Merck KGaA acquisition of Bio-Techne Corporation",
"deal_type": "acquisition",
"latest_event_type": "completed",
"latest_event_name": "<string>",
"summary": "<string>",
"source_document_count": 123,
"event_count": 123,
"terms": {
"headline_value": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"upfront": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"equity": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"royalties": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"territories": [
"<string>"
],
"rights_summary": "<string>"
},
"latest_event_at": "2023-11-07T05:31:56Z",
"activity_date": "2023-11-07T05:31:56Z",
"announced_at": "2023-11-07T05:31:56Z",
"latest_update_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"companies": [
{
"company_id": 239,
"short_name": "merck_kgaa",
"name": "Merck KGaA",
"roles": [
"acquirer"
]
}
],
"total_value": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"upfront": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"development_milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"regulatory_milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"commercial_milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"events": [
{
"event_type": "proposed",
"event_name": "<string>",
"effective_at": "2023-11-07T05:31:56Z",
"source_url": "<string>"
}
],
"source_documents": [
{
"source_vendor": "sec",
"source_kind": "sec_filing",
"source_id": "0001999371-26-013429/ex99-1.htm",
"observed_at": "2023-11-07T05:31:56Z",
"source_url": "<string>",
"published_at": "2023-11-07T05:31:56Z"
}
]
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}Get a deal by id
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.
curl --request GET \
--url https://api.pav.bio/v1/deals/{deal_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pav.bio/v1/deals/{deal_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pav.bio/v1/deals/{deal_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pav.bio/v1/deals/{deal_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pav.bio/v1/deals/{deal_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pav.bio/v1/deals/{deal_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pav.bio/v1/deals/{deal_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"deal_id": "ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210",
"deal_name": "Merck KGaA acquisition of Bio-Techne Corporation",
"deal_type": "acquisition",
"latest_event_type": "completed",
"latest_event_name": "<string>",
"summary": "<string>",
"source_document_count": 123,
"event_count": 123,
"terms": {
"headline_value": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"upfront": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"equity": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"royalties": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"territories": [
"<string>"
],
"rights_summary": "<string>"
},
"latest_event_at": "2023-11-07T05:31:56Z",
"activity_date": "2023-11-07T05:31:56Z",
"announced_at": "2023-11-07T05:31:56Z",
"latest_update_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"companies": [
{
"company_id": 239,
"short_name": "merck_kgaa",
"name": "Merck KGaA",
"roles": [
"acquirer"
]
}
],
"total_value": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"upfront": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"development_milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"regulatory_milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"commercial_milestones": {
"raw_text": "total enterprise value of approximately US$11.3 billion",
"amount": 11300000000,
"currency": "USD",
"percentage": null,
"not_disclosed": false,
"evidence": "<string>"
},
"events": [
{
"event_type": "proposed",
"event_name": "<string>",
"effective_at": "2023-11-07T05:31:56Z",
"source_url": "<string>"
}
],
"source_documents": [
{
"source_vendor": "sec",
"source_kind": "sec_filing",
"source_id": "0001999371-26-013429/ex99-1.htm",
"observed_at": "2023-11-07T05:31:56Z",
"source_url": "<string>",
"published_at": "2023-11-07T05:31:56Z"
}
]
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}{
"error": {
"code": "not_found",
"message": "program 999999 not found",
"request_id": "3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d"
}
}Authorizations
Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer <api_key>.
Path Parameters
Stable Pav deal id.
"ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"
Response
Successful Response
Stable Pav deal identifier.
"ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"
Deal headline.
"Merck KGaA acquisition of Bio-Techne Corporation"
Deal classification.
acquisition, merger, asset_purchase, licensing, collaboration, option, joint_venture, distribution, other "acquisition"
Current lifecycle state. update means the latest mention changed no lifecycle state.
proposed, announced, completed, amended, terminated, update "completed"
Headline of the latest lifecycle event.
One-paragraph deal summary.
Distinct source documents behind the deal.
Lifecycle events recorded for the deal.
Economics and rights across all source documents.
Show child attributes
Show child attributes
Date of the latest lifecycle event, when stated (UTC).
Latest activity: the latest event's date, else its source's publish date. Default sort key.
Announcement date (UTC).
Most recent update mention (UTC).
Completion date (UTC).
Parties linked to Pav companies.
Show child attributes
Show child attributes
Headline (total) deal value, when stated.
Show child attributes
Show child attributes
Upfront consideration.
Show child attributes
Show child attributes
Development milestone economics.
Show child attributes
Show child attributes
Regulatory milestone economics.
Show child attributes
Show child attributes
Commercial / sales milestone economics.
Show child attributes
Show child attributes
Lifecycle events, oldest first.
Show child attributes
Show child attributes
Source documents behind the deal, oldest first.
Show child attributes
Show child attributes