Skip to main content
GET
Get a deal 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

deal_id
string<uuid>
required

Stable Pav 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 lifecycle state. update means the latest mention changed no lifecycle state.

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

"completed"

latest_event_name
string
required

Headline of the latest lifecycle event.

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

Date of the latest lifecycle event, when stated (UTC).

activity_date
string<date-time> | null

Latest activity: the latest event's date, else its 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, when stated.

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.

events
DealEvent · object[]

Lifecycle events, oldest first.

source_documents
DealSourceDocument · object[]

Source documents behind the deal, oldest first.