The Notice API is a RESTful API that can be used to retrieve data about private companies, pricing, indications of interest, and completed trades.
First, make sure you have access to your Notice API Key. If you do not have an API Key or would like to replace your existing one, please contact [email protected]. You will need to submit this API Key with every request as a Bearer token in the Authorization HTTP header like so:
Authorization: Bearer <YOUR_API_KEY>
All endpoints return JSON-formatted responses. You can explore the available endpoints and their specific inputs and outputs using the navigation to the left.
Permissions
Your API package will include with it permissions to access specific endpoints. If you need to confirm which permissions you have access to, contact [email protected].
| Permission | Details |
|---|---|
| Companies | View company details |
| Notice Prices | Pull Notice Price history for privately priced companies |
| Financings | Access basic company financing data such as valuation and amount raised |
| Financings Capital Structure | Access full capital structure including price per share, authorized shares and terms, and more |
| Internal Marks | View internal marks for companies such as 409As and tenders |
| Stock Splits | View company stock splits |
| Trades | View trades on the Notice platform |
| Trade Management | Programmatically manage your own trades on the Notice platform |
| Indications | View indications on the Notice platform |
| Indication Management | Programmatically manage your own indications on the Notice platform |
Response compression
All API endpoints support gzip compression, which can significantly reduce response sizes and improve performance. If using curl you can pass the --compressed flag and it will automatically request gzip compression and decompress the response for you. Or if using a client library that doesn't support automatic decompression, you can send the Accept-Encoding: gzip, deflate header manually and decompress the gzipped response in the code yourself.