# IPOs by Ticker

`GET` `/v1/ipos/{ticker}`

Retrieve the merged IPO record(s) for a single ticker: IPO date, exchange, status, expected price range and share count, prospectus pricing (public price per share, totals, discounts, proceeds) and the list of SEC disclosure filings with document URLs. Ordered by IPO date descending.

## Use cases

- Showing a company's IPO details on a profile page
- Comparing a stock's IPO price to its current price
- Auditing a company's IPO disclosure and prospectus filings
- Enriching newly listed tickers with offering metadata

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ticker` | string | Yes | Ticker. |
| `limit` | integer | No | Max results (default 100). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `results` | array | IPO record(s) for the ticker, most recent IPO date first. |
| `results[].ticker` | string | Ticker. |
| `results[].ipo_date` | string | IPO / expected listing date (YYYY-MM-DD). |
| `results[].company` | string | Company name. |
| `results[].exchange` | string | Listing exchange. |
| `results[].status` | string | IPO status (e.g. Expected, Priced). |
| `results[].shares` | float | Shares offered when available. |
| `results[].price_range` | string | Expected offering price range (USD). |
| `results[].market_cap` | float | Expected market capitalization (USD). |
| `results[].cik` | string | SEC Central Index Key when available. |
| `results[].price_public_per_share` | float | Final prospectus public offering price per share. |
| `results[].price_public_total` | float | Final prospectus gross public offering amount. |
| `results[].proceeds_before_expenses_total` | float | Proceeds before expenses (USD). |
| `results[].disclosures` | array | SEC disclosure filings with document URLs. |
| `results[].prospectus` | array | Prospectus filings with pricing detail and document URLs. |
| `count` | integer | Number of IPO records returned. |

## Example response

```json
{
  "results": [
    {
      "ticker": "RDDT",
      "ipo_date": "2024-03-21",
      "company": "Reddit, Inc.",
      "exchange": "NYSE",
      "status": "Priced",
      "shares": 22000000,
      "price_range": "34.00",
      "market_cap": 6400000000,
      "cik": "0001713445",
      "price_public_per_share": 34,
      "price_public_total": 519000000,
      "proceeds_before_expenses_total": 489000000,
      "disclosures": [
        {
          "filingDate": "2024-03-21",
          "acceptedDate": "2024-03-21",
          "effectivenessDate": "2024-03-20",
          "cik": "0001713445",
          "form": "CERT",
          "url": "https://www.sec.gov/Archives/edgar/data/1713445/000135445724000537/RDDT_8A_Cert.pdf"
        }
      ],
      "prospectus": [
        {
          "filingDate": "2024-03-21",
          "acceptedDate": "2024-03-21",
          "ipoDate": "2024-03-21",
          "cik": "0001713445",
          "form": "424B4",
          "pricePublicPerShare": 34,
          "pricePublicTotal": 519000000,
          "discountsAndCommissionsPerShare": 1.36,
          "discountsAndCommissionsTotal": 20760000,
          "proceedsBeforeExpensesPerShare": 32.64,
          "proceedsBeforeExpensesTotal": 489000000,
          "url": "https://www.sec.gov/Archives/edgar/data/1713445/000119312524072690/d633612d424b4.htm"
        }
      ]
    }
  ],
  "count": 1
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/ipos/RDDT?apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.get_ipos("RDDT")

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.getIpos("RDDT");

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.GetIpos("RDDT")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.getIpos("RDDT");

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.get_ipos("RDDT")

pp result
```