Skip to main content
GET
List and search 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

Exact-term text or party-name substring.

Example:

"Bio-Techne"

company_id
integer[] | null

Deals with any of these Pav company ids as a party. Repeatable.

deal_type
enum<string>[] | null

Restrict to these deal types. Repeatable.

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

"licensing"

event_type
enum<string>[] | null

Restrict to deals whose current lifecycle state is one of these. Repeatable.

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

"completed"

announced_from
string<date> | null

Announced on or after this date (inclusive).

announced_to
string<date> | null

Announced on or before this date (inclusive).

min_value_usd
number | null

Minimum headline deal value in USD. Only USD deals with a stated headline value qualify; many deals disclose none.

Required range: x >= 0
Example:

1000000000

sort
enum<string>
default:latest_activity

latest_activity (default), announced_at, completed_at, or headline_value; newest or largest first.

Available options:
latest_activity,
announced_at,
completed_at,
headline_value
limit
integer
default:25

Rows per page (1-100).

Required range: 1 <= x <= 100
offset
integer
default:0

Zero-based row offset for paging.

Required range: 0 <= x <= 100000
include_total
boolean
default:false

Compute the exact total match count.

Response

Successful Response

data
Deal · object[]
required

Page of deals.

pagination
Pagination · object
required

Pagination metadata for this page.