Get acquisitions by date

curl --request GET \
  --url https://app.tryspecter.com/api/v1/acquisitions \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/acquisitions', 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://app.tryspecter.com/api/v1/acquisitions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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://app.tryspecter.com/api/v1/acquisitions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/acquisitions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "acquisition_id": "acq_fd583a1b99d5c85635a56283",
    "acquirer_company_id": "6576fa02f5c870dd55a4982a",
    "acquirer_name": "Uber",
    "acquiree_company_id": "5e3ba36800c8f4c9668e5b8f",
    "acquiree_name": "Delivery Hero",
    "acquirer_domain": "uber.com",
    "acquiree_domain": "deliveryhero.com",
    "acquisition_type": "acquisition",
    "price_usd": 14564220183,
    "acquisition_date": "2026-07-16"
  }
]

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Transactions

Get acquisitions by date

Returns acquisitions across all companies, newest first. Each item is the same PublicAcquisition object returned by Get acquisition by ID: every row carries both sides of the deal (the acquirer and the acquiree), each with their Specter company ID and primary domain so you can chain to Get company by ID for either party.

Costs 1 credit per request, returning up to 50 results per page.

What you need

Nothing beyond your API key — the feed spans every company. Narrow it with acquired_date_after / acquired_date_before, and walk it with page and limit.

Behaviour

Ordered by acquisition date, newest first, at most 50 results per page.
Both date bounds are inclusive and each stands alone: send only acquired_date_after for everything since a date, only acquired_date_before for everything up to one, or both for a window.
Every response carries X-Total-Count, X-Page, X-Page-Size, X-Total-Pages and a Link header, so you can size a range before paging through it.
A range with no acquisitions returns 200 with an empty array, and an empty page is not billed.

What you do next

Pull either side of the deal. Take acquirer_company_id or acquiree_company_id to Get company by ID.
Re-read one row. Take acquisition_id to Get acquisition by ID.
Poll for new deals. Re-run with acquired_date_after set to your last poll date to collect only what has been announced since.

GET

acquisitions

Get acquisitions by date

curl --request GET \
  --url https://app.tryspecter.com/api/v1/acquisitions \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/acquisitions', 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://app.tryspecter.com/api/v1/acquisitions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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://app.tryspecter.com/api/v1/acquisitions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/acquisitions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "acquisition_id": "acq_fd583a1b99d5c85635a56283",
    "acquirer_company_id": "6576fa02f5c870dd55a4982a",
    "acquirer_name": "Uber",
    "acquiree_company_id": "5e3ba36800c8f4c9668e5b8f",
    "acquiree_name": "Delivery Hero",
    "acquirer_domain": "uber.com",
    "acquiree_domain": "deliveryhero.com",
    "acquisition_type": "acquisition",
    "price_usd": 14564220183,
    "acquisition_date": "2026-07-16"
  }
]

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key

string

header

required

Query Parameters

acquired_date_after

string<date>

Only return acquisitions dated on or after this date (YYYY-MM-DD, inclusive).

Example:

"2026-06-01"

acquired_date_before

string<date>

Only return acquisitions dated on or before this date (YYYY-MM-DD, inclusive).

Example:

"2026-06-30"

page

number

The page number of results to return, base 0, default is 0.

limit

integer

default:50

The number of results to return per page (minimum 1, maximum 50, default 50). A page is the unit these endpoints are priced in, so it cannot be widened beyond 50.

Required range: 1 <= x <= 50

Response

A page of acquisitions.

acquisition_id

string

required

The Specter ID for this acquisition.

Example:

"acq_fd583a1b99d5c85635a56283"

acquirer_company_id

string

required

The Specter company ID of the acquirer. Use with GET /companies/{companyId} to fetch the full company record.

Example:

"6576fa02f5c870dd55a4982a"

acquirer_name

string

required

The acquirer company's name.

Example:

"Uber"

acquiree_company_id

string

required

The Specter company ID of the acquiree. Use with GET /companies/{companyId} to fetch the full company record.

Example:

"5e3ba36800c8f4c9668e5b8f"

acquiree_name

string

required

The acquiree company's name.

Example:

"Delivery Hero"

acquirer_domain

string | null

The acquirer's primary domain.

Example:

"uber.com"

acquiree_domain

string | null

The acquiree's primary domain.

Example:

"deliveryhero.com"

acquisition_type

enum<string> | null

The type of deal. One of acquisition, merge, lbo, acquihire, or management_buyout. Null when Specter could not classify the deal.

Available options:

acquisition,

merge,

lbo,

acquihire,

management_buyout

Example:

"acquisition"

price_usd

integer | null

Deal value in USD, if disclosed.

Example:

14564220183

acquisition_date

string<date> | null

Date the acquisition was announced or closed (YYYY-MM-DD).

Example:

"2026-07-16"

Enrich

Search

Companies

People

Investors

Transactions

Signals

Lists

Saved Searches

Network

Account

Get acquisitions by date

What you need

Behaviour

What you do next

Authorizations

Query Parameters

Response