SPAC Research API Reference
Getting Started
SPAC Research's REST API uses standard HTTP codes, verbs, and authentication, and returns JSON-encoded responses.
All endpoints are hosted under the www.spacresearch.com
domain over HTTPS-only. All requests must
be authorized with the
HTTP Authorization
header.
Please read the API License Agreement before using the SPAC Research API.
March 22nd, 2023 new
Authentication
Send the HTTP Authorization
header in each request.
Substitute the text API_SECRET_TOKEN
in the example below with your API token, which can be found on
your
account page.
GET /api/v1/company HTTP/1.1
Host: www.spacresearch.com
Authorization: Bearer API_SECRET_TOKEN
The following Python script demonstrates Bearer token authentication, and requesting SPAC
data from the GET /api/v1/company
endpoint:
import requests
def get_active_companies():
end_point = "https://www.spacresearch.com/api/v1/company?status=active"
print("Connecting to: ", end_point)
token = "Bearer {}".format(YOUR_API_TOKEN)
return requests.get(end_point, headers={"Authorization": token})
Bulk SPAC Data
Request data for US-listed SPACs, by company status.
GET /api/v1/company
Example Requests
Get all active companies:
https://www.spacresearch.com/api/v1/company
Get all pre-IPO companies:
https://www.spacresearch.com/api/v1/company?status=pre-ipo
Get the name and IPO date of each company with a closed deal:
https://www.spacresearch.com/api/v1/company?status=deal-closed&select=name,ipoDate
Query Parameters
Name | Value |
---|---|
status |
(Optional) Filter companies in response by status.
Other
|
select |
(Optional) Comma-separated list of field names to include in the response. Example: |
Response Schema
Name | Description | Type | Status |
---|---|---|---|
id |
Unique identifier for each SPAC | String (UUID) | Default |
name |
Corporate name of entity | String | Default |
abbreviatedName |
An abbreviated version of the corporate entity's name |
String | Default |
status |
One of pre-ipo , pre-deal , live-deal , deal-closed ,
stalled , or liquidated
|
String | Default |
symbols |
Array of symbol metadata; see Symbol metadata section | Array | Default |
secFilingLink |
Link to the SPAC's SEC filing index | String | Default |
initialS1Date |
Date of initial S-1 filing | String (ISO-8601) | Default |
tenor |
Life of SPAC in months, including sponsor-optional extensions | String | Default |
unitSpecs |
Composition of units. Example: U=S+W/2 . Meaning: Units consist of one common share and ½ warrant
|
String | Default |
warrantSpecs |
Composition of warrants. Example: W=S@11.5 . Meaning: Warrants can purchase one share of common
stock at a price of $11.50 per share.Note: this field may occasionally contain asterisks that will require manual attention to parse. |
String | Default |
rightSpecs |
Composition of rights. Note: this field may occasionally contain asterisks that will require manual attention to parse. |
String | Default |
warrantRedemptionPrice |
Price above which warrants may be called for redemption | Numeric | Default |
warrantCrescentTerm |
Warrant exercise adjustment threshold price for equity issuance at business combination closing | Numeric | Default |
underwriters |
Array of underwriter objects; see Underwriters section | Array | Default |
sponsorFamilies |
Array of sponsor objects; see Sponsors section | Array | Default |
sponsorType |
Type of entity sponsoring the SPAC: IB, HF, PE, VC, FO, Independent (former public company CEO), Independent (other) | String | Default |
anchorInvestors |
Array of anchor investor objects; see Anchor Investors section | String | Default |
personnel |
Array of personnel metadata; see Directors & Officers section | Array | Default |
issuerCounsel |
Issuer Legal Counsel | String | Default |
auditor |
Auditor | String | Default |
underwriterCounsel |
Underwriter Legal Counsel | String | Default |
incorporation |
Corporate domicile | String | Default |
address |
Corporate address | String | Default |
publicUnits |
Number of public units sold at IPO, including over-allotment | Numeric | Default |
unitIpoPrice |
Price per unit of SPAC IPO | Numeric | Default |
ipoCashInTrust |
Percentage representing the amount of capital raised at IPO that was deposited in the SPAC's trust account (per share) | String | Default |
trustAtIpo |
Aggregate value of cash deposited into the SPAC's trust account at IPO (including over-allotment, if finalized) | Numeric | Default |
notableAffiliates |
Notable entities affiliated with the SPAC or its sponsor | String | Default |
intendedSector |
Long-form description of SPAC focus area from S-1 | String | Default |
ipoSectorTag |
SPAC Sector Focus at IPO | String | Default |
ipoGeographyTag |
SPAC Geographic Focus at IPO | String | Default |
mergerSectorTag |
Sector of SPAC Acquisition Target | String | Default |
mergerGeographyTag |
Geography of SPAC Acquisition Target | String | Default |
fpaAmount |
Dollar amount of forward purchase commitment | Numeric | Default |
forwardPurchaser |
Name(s) of forward purchase investors | String | Default |
fpaContent |
Details of forward purchase commitment | String | Default |
bcma |
Business combination marketing agreement as a percentage of IPO proceeds | String | Default |
uwDeferred |
Deferred underwriting commissions payable to underwriters upon closing of initial business combination | String | Default |
uwUpfront |
Upfront underwriting commissions earned by underwriters | String | Default |
timeWindowTooltip |
Detailed description of SPAC's tenor/lifespan | String | Default | trustAcctValue |
Value of trust account | Numeric | Pre-IPO Active |
trustSharePrice |
Last reported trust value | Numeric | Pre-IPO Active |
trustAcctDate |
Date of SPAC's most recent definitive trust account update | String (ISO-8601) | Active |
trustHeldInCash |
Binary flag representing whether or not the SPAC has given guidance indicating a reasonable likelihood of having moved its trust account to cash Type: Boolean | Boolean | Active |
estimatedCashInTrustPerShare |
Estimated current cash in trust per share, per SPAC Research estimated trust model. Uses most recent reported trust value from company filings and applies lookback on 1- and 6-month Treasury rates. Accounts for income & franchise taxes, sponsor contributions to trust, and working capital withdrawals (if any). THIS FIELD IS ONLY AN ESTIMATE. |
Numeric | Active |
estimatedCashAtLiquidation |
Estimated cash in trust per share at End Date. Assumes no optional extensions. | Numeric | Active |
trustEstimateUpdated |
Date and time of last update to estimated trust value. | String (ISO-8601) | Active |
target |
True if the SPAC has an active definitive business combination agreement, otherwise false | Boolean | Active |
targetName |
Name of acquisition target/newco | String | Active Archive |
publicSharesOutstanding |
Number of outstanding public shares after any effected extension/closing redemptions | Numeric | Active |
enterpriseValue |
Pro forma enterprise value of newco | Numeric | Active Archive |
publicWarrantsOutstanding |
Number of outstanding warrants | Numeric | Active Archive |
ipoDate |
First date of live trading of units | String (ISO-8601) | Active Archive |
dealAnnouncementDate |
Date of business combination announcement | String (ISO-8601) | Active Archive |
atRiskCapital |
Dollar amount of risk capital securities purchased by sponsor | Numeric | Active Archive |
atRiskUnitsPurchased |
Number of private placement units purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskCommonPurchased |
Number of private placement common shares purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskWarrantsPurchased |
Number of private placement warrants purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskRightsPurchased |
Number of private placement right purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskSponsorPromoteShares |
Original number of promote shares owned by the SPAC's sponsor | Numeric | Active Archive |
pipeInvestment |
Dollar value of PIPE commitments subscribed for in connection with initial business combination | Numeric | Active Archive |
pipePrice |
Price per share at which PIPE commitments were/are to be funded | Numeric | Active Archive |
pipeWarrantConsideration |
Total warrants (if any) granted to PIPE purchasers in connection with initial business combination | Numeric | Active Archive |
minCashCondition |
Minimum cash requirement for seller to be required to consummate business combination | Numeric | Active Archive |
endDate |
Date by which SPAC must consummate a business combination or commence liquidating its trust account | String (ISO-8601) | Active |
mergerOutsideDate |
If present, date after which a SPAC’s definitive business combination agreement may be terminated. Merger Outside Date may be conditional and should be carefully reviewed. |
String (ISO-8601) | Active |
outsideLiquidationDate |
If present, date to which SPAC's liquidation deadline may be extended without submission for shareholder vote. | String (ISO-8601) | Active |
closingOrLiquidationDate |
Date on which this SPAC moved from "active" to "archive" status due to either closing of initial business combination or liquidation | String (ISO-8601) | Active Archive |
proxyFilingDate |
Date on which the first preliminary proxy related to the SPAC’s business combination was filed | String (ISO-8601) | Active Archive |
newTickerSymbol |
New ticker symbol for post-merger common stock (if present) | String | Active Archive |
archiveSymbols |
Array of post-merger symbol metadata; see Archive Symbol metadata section | Array | Active Archive |
redemptionRatio |
Percentage of original SPAC public shares that were redeemed over the course of that SPAC's life. | String | Archive |
convertiblePreferredInvestment |
Amount of investment in convertible or preferred equity made at deal closing. | Numeric | Active Archive |
conversionStrikePrice |
Price at which convertible/preferred investment may be converted into common equity. | Numeric | Active Archive |
closingFpaInvestment |
Amount of FPA that was actually effected at closing, in dollars. | Numeric | Active Archive |
closingFpaShares |
Number of shares of common stock received by investors in connection with Closing FPA Investment. | Numeric | Active Archive |
closingFpaWarrantConsideration |
Number of warrants (if any) received by investors in connection with Closing FPA Investment. | Numeric | Active Archive |
closingFpaImpliedPrice |
Implied price per share of common equity purchased in closing FPA Investment (including all shares received by purchasers but ignoring the value of any warrant consideration). | Numeric | Active Archive |
backstopInvestment |
Amount of any backstop investment actually effected at closing. | Numeric | Active Archive |
backstopImpliedPricePerShare |
Implied price per share of common equity purchased in backstop investment at closing (including all shares received by purchasers but ignoring the value of any warrant consideration). | Numeric | Active Archive |
backstopShares |
Number of shares of common stock received by investors in connection with Backstop Investment. | Numeric | Active Archive |
backstopWarrantConsideration |
Number of warrants (if any) received by backstop investors in connection with backstop investment. | Numeric | Active Archive |
sponsorShareForfeiture |
Number of shares conditionally or unconditionally forfeited by sponsor in connection with deal closing. | Numeric | Archive |
sponsorWarrantForfeiture |
Number of warrants conditionally or unconditionally forfeited by sponsor in connection with deal closing. | Numeric | Archive |
sellerEarnout |
Array of seller Earnout objects; see Seller Earnout Metadata section | Array | Archive |
sponsorEarnout |
Array of sponsor Earnout objects; see Sponsor Earnout Metadata section | Array | Archive |
sellerLockup |
Array of seller Lockup objects; see Seller Lockup Metadata section | Array | Archive |
sponsorLockup |
Array of sponsor Lockup objects; see Sponsor Lockup Metadata section | Array | Archive |
/company?status=
values in the table above.
Default fields are returned for all statuses.
"abbreviatedName": "XYZ Strategic Growth",
"address": "123 West 57th Street, 49th Floor New York, NY 10019",
"atRiskCapital": 18336201,
"atRiskCommonPurchased": 1100000,
"atRiskSponsorPromoteShares": 20420250,
"atRiskUnitsPurchased": 500000,
"atRiskWarrantsPurchased": 12224134,
"bcma": "3.50%",
"auditor": "WithumSmith+Brown",
"backstopImpliedPricePerShare": 10.20,
"backstopInvestment": 4151400,
"backstopShares": 407000,
"backstopWarrantConsideration": 3250000,
"closingFpaImpliedPrice": 10.00,
"closingFpaInvestment": 300000000,
"closingFpaShares": 30000000,
"closingOrLiquidationDate": "2018-02-06",
"composition": {
"unit": {
"share": 1,
"warrant": 0.3333333333333333
},
"warrant": {
"share": 1,
"strike": 11.5
}
},
"conversionStrikePrice": 5.00,
"convertiblePreferredInvestment": 4000000,
"dealAnnouncementDate": "2021-02-17",
"endDate": "2022-10-06",
"enterpriseValue": 1638000000,
"estimatedCashAtLiquidation": 10.028,
"estimatedCashInTrustPerShare": 10.01,
"forwardPurchaser": "X Holdings and Y LLC",
"fpaAmount": 300000000,
"fpaContent": "* Each of X and Y have entered in FPAs to purchase $150mm (or a total of $300mm) of securities at business combination",
"id": "b2c10a29-0c18-442a-9be4-5e9604700044",
"incorporation": "Cayman Islands",
"initialS1Date": "2020-09-16",
"intendedSector": "Not specified",
"ipoCashInTrust": "100.0%",
"ipoDate": "2020-10-02",
"ipoGeographyTag": "Global",
"ipoSectorTag": "General",
"issuerCounsel": "Paul, Weiss, Rifkind, Wharton & Garrison",
"mergerGeographyTag": "US\/Canada",
"mergerOutsideDate": "2021-12-31",
"mergerSectorTag": "Automotive",
"minCashCondition": 225000000,
"name": "XYZ Strategic Growth Capital",
"newTickerSymbol": "XYZZ",
"notableAffiliates": "Apollo Global Management, Inc.",
"outsideLiquidationDate": "2023-01-06",
"pipeInvestment": 225000000,
"pipePrice": 10.00,
"pipeWarrantConsideration": 4100000,
"proxyFilingDate": "2021-05-13",
"publicSharesOutstanding": 81681000,
"publicUnits": 81681000,
"publicWarrantsOutstanding": 27227000,
"redemptionRatio": "84.2%",
"rightSpecs": "R=S\/20",
"rootSymbol": "APSG.U",
"secFilingLink": "https:\/\/www.sec.gov\/edgar\/browse\/?CIK=0001820872",
"sponsorType": "PE (Private Equity)",
"status": "pre-ipo",
"target": false,
"targetName": "AEye",
"tenor": "24+(3)",
"timeWindowTooltip": "12 months, plus 2 optional 3 month extensions, each of which require a $0.10 per public share deposit from sponsor to the trust account"
"trustAcctDate": "2021-03-31",
"trustAcctValue": 817161720,
"trustAtIpo": 816810000,
"trustEstimateUpdated": "2022-03-09T07:56:52.000-06:00",
"trustHeldInCash": true,
"trustSharePrice": 10.00,
"underwriterCounsel": "White & Case",
"unitIpoPrice": 10.0,
"unitSpecs": "U=S+W\/3",
"uwDeferred": "3.50%",
"uwUpfront": "2.00%",
"warrantCrescentTerm": 9.20,
"warrantRedemptionPrice": 18.00,
"warrantSpecs": "W=S@11.5",
"sponsorShareForfeiture": 2565885,
"sponsorWarrantForfeiture": 2565885
Symbol Metadata
Name | Description | Type |
---|---|---|
symbol |
Ticker symbol | String |
type |
Stock type e.g. common, units, warrants, rights | String |
isin |
International Securities Identification Number
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
cusip |
Committee on Uniform Securities Identification Procedures
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
"symbols": [
{
"symbol": "MNCLU",
"type": "units",
"cusip": "609754205",
"isin": "US6097542053"
},
{
"symbol": "MNCLW",
"type": "warrants",
"cusip": "609754114",
"isin": "US6097541147"
},
{
"symbol": "MNCL",
"type": "common",
"cusip": "609754106",
"isin": "US6097541063"
}
],
Archive Symbol Metadata
Name | Description | Type |
---|---|---|
symbol |
Ticker symbol | String |
type |
Stock type e.g. common, warrants | String |
isin |
International Securities Identification Number
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
cusip |
Committee on Uniform Securities Identification Procedures
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
"archiveSymbols": [
{
"symbol": "CCNC",
"type": "common",
"cusip": "19200A105",
"isin": "US19200A1051"
},
{
"symbol": "CCNCW",
"type": "warrants",
"cusip": "19200A113",
"isin": "US19200A1135"
}
],
Underwriters
Name | Description | Type |
---|---|---|
name |
Underwriter name | String |
units |
Number of units sold by underwriter | Numeric |
bookRunningManager |
True if the underwriter is the designated book-running manager | Boolean |
"underwriters": [
{
"name": "Cowen and Company, LLC",
"units": 12000000,
"bookRunningManager": true
},
{
"name": "Chardan Capital Markets, LLC",
"units": 3000000,
"bookRunningManager": true
}
],
Sponsor Families
Name | Description | Type |
---|---|---|
Name | Sponsor name | String |
"sponsorFamilies": [
{
"name": "Apollo Global Management"
},
{
"name": "Cohen and Company"
}
],
Directors & Officers
Name | Description | Type |
---|---|---|
name |
Director or officer name | String |
position |
Director or officer position | String |
"personnel": [
{
"name": "Linda Sample",
"position": "Chief Executive Officer and Director"
},
{
"name": "Fred Sample",
"position": "Director"
}
],
Anchor Investors
Name | Description | Type |
---|---|---|
name |
Name of anchor investor | String |
size |
Size of anchor investment, measured as a proportion of original IPO size without over-allotment | Numeric |
"anchorInvestors": [
{
"name": "D. E. SHAW & CO., INC.",
"size": 9.9
},
{
"name": "RADCLIFFE CAPITAL MANAGEMENT, L.P.",
"size": 9.9
}
],
Seller Earnout Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares sellers can earn upon achievement of the relevant milestone and within the specified timeframe | Numeric |
period |
Time period over which earnout shares may be earned | String |
trigger |
Milestone to be achieved for earnout shares to be released | String |
"sellerEarnout": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Sponsor Earnout Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares sponsor can earn upon achievement of the relevant milestone and within the specified timeframe | Numeric |
period |
Time period over which earnout shares may be earned | String |
trigger |
Milestone to be achieved for earnout shares to be released | String |
"sponsorEarnout": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Seller Lockup Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares that will be released to sellers upon expiration of the relevant lockup period | Numeric |
period |
Length of period upon which lockup shares will be unconditionally released to sellers | String |
trigger |
Milestone which will end lockup period early | String |
"sellerLockup": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Sponsor Lockup Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares that will be released to sponsor upon expiration of the relevant lockup period | Numeric |
period |
Length of period upon which lockup shares will be unconditionally released to sponsor | String |
trigger |
Milestone which will end lockup period early | String |
"sponsorLockup": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
SPAC Lookup
Request data on a specific SPAC.
GET /api/v1/company/:id
Path Parameters
Name | Value |
---|---|
:id |
The following identifiers are accepted:
|
Request Examples
-
Get a company by ID:
GET /api/v1/company/99a035ce-e3df-42ef-b545-743ff3d982a6
-
Get a company by root symbol:
GET /api/v1/company/MNCLU
Response Schema
Returns a single company object, using the response schema of the GET
/api/v1/company
endpoint above.
Event Feed
Get a feed of SPAC events.GET /calendar.json
Query Parameters
Name | Value |
---|---|
since |
(Optional) Earliest event date, e.g. 2021-03-23 |
Request Examples
-
Get events dating back to the beginning of the current month:
GET /calendar.json
-
Get events dating back to January 15, 2021:
GET /calendar.json?since=2021-01-15
Response Schema
Name | Description | Type |
---|---|---|
id |
Unique identifier for each calendar event | String |
root-symbol |
Company identifier | String |
company-name |
Name of SPAC | String |
date |
Event date | String (ISO-8601) |
title |
Event title | String |
record-date |
Record date of meeting (if any) | String (ISO-8601) |
[
{
"root-symbol": "BLNGU",
"company-name": "Belong Acquisition Corp.",
"date": "2021-07-23",
"title": "IPO",
"id": "b184ccfb-9ab6-3a6a-ae59-e59676d796d5",
},
{
"root-symbol": "CCIV.U",
"company-name": "Churchill Capital Corp IV",
"date": "2021-07-23",
"title": "Lucid Motors Vote",
"id": "3c929dc8-a2ed-32b6-b4e9-76717eb82430",
"record-date" : "2021-08-23"
},
{
"root-symbol": "AAOIU",
"company-name": "American Acquisition Opportunity Inc.",
"date": "2022-03-22",
"title": "Liq. date",
"id": "8ea2ebf7-da07-38b9-894c-4aa52e5b9e5b"
}
]