Skip to main content
GET
List deals

Authorizations

Authorization
string
header
required

Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer <api_key>.

Query Parameters

q
string | null

Free text.

Maximum string length: 300
company_id
string[] | null

Company ids, comma-separated. Includes the companies each one owns.

Example:

"412"

drug_id
string[] | null

Drug ids, comma-separated.

Example:

"5120"

deal_type
string[] | null

Deal types, comma-separated: acquisition, merger, asset_purchase, licensing, collaboration, option, joint_venture, distribution, other.

Example:

"licensing"

status
string[] | null

Current lifecycle state (latest_event_type), comma-separated: proposed, announced, completed, amended, terminated, update.

Example:

"completed"

target
string[] | null

Target name, gene symbol or term id; comma-separated.

Example:

"TL1A"

modality
string[] | null

Modality, subclass or format; comma-separated.

Example:

"adc"

therapeutic_area
string[] | null

Areas, comma-separated: cardiovascular, dermatology, endocrine_metabolic, gastroenterology, hematology, hepatology, immunology, infectious_disease, musculoskeletal, nephrology, neurology, oncology, ophthalmology, otolaryngology, psychiatry, reproductive_womens_health, respiratory, urology_mens_health.

Example:

"oncology"

min_value_usd
number | null

Minimum total_potential_value in USD.

Required range: x >= 0
Example:

1000000000

from
string<date> | null

On or after this date.

to
string<date> | null

On or before this date.

sort
string | null

One of activity_date, announced_at, completed_at, total_value, total_potential_value; prefix - to descend. Default -activity_date.

limit
integer
default:50

Rows per page (1-200).

Required range: 1 <= x <= 200
Example:

50

cursor
string | null

next_cursor from the previous page.

Maximum string length: 2000

Response

Successful Response

data
Deal · object[]
required

Page of deals.

next_cursor
string | null

Pass as cursor to get the next page. Null on the last page. See Conventions.

Example:

"eyJyIjoicHJvZ3JhbXMiLCJzIjoiY29tcGFueSJ9"

total
integer | null

Rows matching the filters. Null for relevance-ranked q results.

Example:

1284