> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# IPOs India API

> Indian IPOs with name, category, exchange, status and issue price, for the mainboard, SME or both.

`POST /v1/data/ipos/india/run`

**Pricing:** $0.0045 per IPO ($4.50 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**board** `string` (default: all)

Which IPOs: Mainboard, SME, or all. All by default.

Allowed values: `all` (All), `mainboard` (Mainboard only), `sme` (SME only).

**maxResults** `integer` (default: 100)

How many IPOs to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/ipos/india/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "board": "all",
    "maxResults": 25
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/ipos/india/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "board": "all",
    "maxResults": 25
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/ipos/india/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "board": "all",
  "maxResults": 25
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one IPO, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `slug` | Slug | text |
| `ipoName` | Ipo Name | text |
| `category` | Category | text |
| `exchange` | Exchange | text |
| `status` | Status | text |
| `statusText` | Status Text | text |
| `issuePrice` | Issue Price | number |
| `lotSize` | Lot Size | number |
| `issueSizeCr` | Issue Size Cr | number |
| `priceToEarnings` | Price To Earnings | number |
| `openDate` | Open Date | date |
| `closeDate` | Close Date | date |
| `allotmentDate` | Allotment Date | date |
| `listingDate` | Listing Date | date |
| `gmp` | Gmp | number |
| `gmpPercent` | Gmp Percent | number |
| `gmpUpdatedOn` | Gmp Updated On | text |
| `subscriptionTotal` | Subscription Total | number |
| `anchorInvestors` | Anchor Investors | boolean |
| `url` | URL | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "ipos/india",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "statusText": "Upcoming",
      "exchange": "NSE SME",
      "ipoName": "Vedant Poly Fabs",
      "issuePrice": 94,
      "closeDate": "2026-11-04",
      "allotmentDate": "2026-11-05",
      "gmpPercent": 5.32,
      "subscriptionTotal": null,
      "url": "https://www.investorgain.com/ipo/vedant-poly-fabs-ipo/2297/",
      "slug": "vedant-poly-fabs-ipo",
      "gmp": 5,
      "category": "SME",
      "status": "Upcoming",
      "lotSize": 1200,
      "openDate": "2026-11-02",
      "listingDate": "2026-11-09",
      "anchorInvestors": false,
      "issueSizeCr": 56.68,
      "gmpUpdatedOn": "1-Nov 17:02",
      "priceToEarnings": 12.62
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.