Filings

Get IPO filings

Returns the S-1 and S-1/A registration statements one issuer has filed, newest first, from the same filings feed get_filings reads (go/service/ipos.go). ticker is REQUIRED: that feed is keyed on a single issuer and cannot list registrations across the whole market, so an omitted ticker answers a bad_request naming the reason rather than a guess. This is a documented deviation - Financial Datasets answers this route unscoped. classification is accepted for parameter parity but every call that sets it answers HTTP 200 with a bad_request ErrorResponse body: this server reports the filings SEC publishes and does not classify them as ipo, spac, shell_company or resale, and silently ignoring the filter would return a set the caller did not ask for.

GET

ipos

Get IPO filings

curl --request GET \
  --url https://financialdatasets.rip/ipos \
  --header 'X-API-KEY: <api-key>'

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

fetch('https://financialdatasets.rip/ipos', 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://financialdatasets.rip/ipos",
  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://financialdatasets.rip/ipos"

	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://financialdatasets.rip/ipos")

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

{
  "ipos": [
    {
      "accession_number": "0001628280-24-006294",
      "cik": "1713445",
      "form_type": "S-1",
      "filing_date": "2024-02-22",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/0001713445/000162828024006294/reddits-1q423.htm",
      "ticker": "RDDT"
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

Ticker of the issuer whose registration statements to list, for example RDDT. Required.

cik

string

SEC CIK of the filer. Accepted for Financial Datasets parameter parity; this route resolves the CIK from the filing itself.

classification

enum<string>

Accepted for parameter parity, but every call that sets it answers a bad_request ErrorResponse body; this server does not classify registration filings.

Available options:

ipo,

shell_company,

spac,

resale,

other

filing_date

string<date>

Restricts to registrations whose filing_date exactly equals this date (YYYY-MM-DD).

filing_date_gte

string<date>

Restricts to registrations filed on or after this date (YYYY-MM-DD).

filing_date_lte

string<date>

Restricts to registrations filed on or before this date (YYYY-MM-DD).

filing_date_gt

string<date>

Restricts to registrations filed strictly after this date (YYYY-MM-DD).

filing_date_lt

string<date>

Restricts to registrations filed strictly before this date (YYYY-MM-DD).

limit

integer

default:10

Number of records to retrieve (default: 10, max: 1000).

Required range: 1 <= x <= 1000

cursor

string

Opaque base64url pagination cursor from a previous response's next_page_url.

Response

Registration statements for the issuer, newest first.

List envelope: {"ipos": [...]}, with next_page_url present only when more records remain.

ipos

Ipo · object[]

required

Show child attributes

next_page_url

string

Absolute URL of the next page. Present only when more records remain.

Get IPO filings

curl --request GET \
  --url https://financialdatasets.rip/ipos \
  --header 'X-API-KEY: <api-key>'

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

fetch('https://financialdatasets.rip/ipos', 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://financialdatasets.rip/ipos",
  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://financialdatasets.rip/ipos"

	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://financialdatasets.rip/ipos")

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

{
  "ipos": [
    {
      "accession_number": "0001628280-24-006294",
      "cik": "1713445",
      "form_type": "S-1",
      "filing_date": "2024-02-22",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/0001713445/000162828024006294/reddits-1q423.htm",
      "ticker": "RDDT"
    }
  ]
}

Financial statements

Financial metrics

Earnings

Filings

Prices

News

Insider trades

Screener

Company

KPIs

Not implemented

Macroeconomics

Index funds

Institutional holdings

Ownership

Get IPO filings

Authorizations

Query Parameters

Response