Skip to main content
GET
Get a deal

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

deal_id
string<uuid>
required

Deal id.

Example:

"ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"

Response

Successful Response

deal_id
string<uuid>
required

Stable Pav deal identifier.

Example:

"ec0bcf74-fdc0-4ffa-ad04-fe25ed8d6210"

deal_name
string
required

Deal headline.

Example:

"Merck KGaA acquisition of Bio-Techne Corporation"

deal_type
enum<string>
required

Deal classification.

Available options:
acquisition,
merger,
asset_purchase,
licensing,
collaboration,
option,
joint_venture,
distribution,
other
Example:

"acquisition"

latest_event_type
enum<string>
required

Current state: proposed, announced, amended, completed or terminated. Never moves backwards.

Available options:
proposed,
announced,
completed,
amended,
terminated,
update
Example:

"completed"

latest_event_name
string
required

Headline of the event that set the current state.

summary
string
required

One-paragraph deal summary.

source_document_count
integer
required

Distinct source documents behind the deal.

event_count
integer
required

Lifecycle events recorded for the deal.

terms
DealTerms · object
required

Economics and rights across all source documents.

latest_event_at
string<date-time> | null

When the current state took effect (UTC), when stated.

activity_date
string<date-time> | null

Latest activity: the later of latest_event_at and latest_update_at, else the latest source's publish date. Default sort key.

announced_at
string<date-time> | null

Announcement date (UTC).

latest_update_at
string<date-time> | null

Most recent update mention (UTC).

completed_at
string<date-time> | null

Completion date (UTC).

companies
DealCompany · object[]

Parties linked to Pav companies.

total_value
DealValue · object | null

Headline (total) deal value as the announcement states it, updated when an acquisition price is amended. Never a per-share price.

total_potential_value
DealValue · object | null

total_value when stated, else upfront plus milestones in one currency.

upfront
DealValue · object | null

Upfront consideration.

development_milestones
DealValue · object | null

Development milestone economics.

regulatory_milestones
DealValue · object | null

Regulatory milestone economics.

commercial_milestones
DealValue · object | null

Commercial / sales milestone economics.

assets
DealAsset · object[]

Drugs the deal covers. Empty when it names no specific drug.

targets
DealTarget · object[]

Molecular targets of the deal's drugs, as ontology terms.

modalities
string[]

Modalities of the deal's drugs, in Pav's modality vocabulary.

Example:
therapeutic_areas
string[]

Therapeutic areas of the diseases the deal's drugs are developed for, as area slugs (for example oncology, immunology, endocrine_metabolic).

Example:
events
DealEvent · object[]

Lifecycle events, oldest first.

source_documents
DealSourceDocument · object[]

Source documents behind the deal, oldest first.