Upcoming IPO Data API - Consolidated Indian Market Feed
Unified listing of both Mainboard and SME IPOs sorted chronologically by open and listing dates. Ideal for building universal search and master market tables.
Endpoint Overview & Architecture
The Combined All IPOs Feed provides a complete unified stream spanning both Mainboard and SME equity public issues in a single API call. Rather than executing concurrent queries against separate segment endpoints, this endpoint allows developers to hydrate master search bars, calendar widgets, and market landing pages with one fast request.
Each record in the combined feed is tagged with its definitive market segment classification (MAINBOARD or SME), exchange associations (BSE, NSE, or both), and current issue status. It is chronologically indexed by issue opening dates so users can immediately distinguish between currently open, upcoming, and recently listed issues.
By using this master endpoint with client-side caching or edge server-side rendering (SSG/ISR), financial platforms achieve sub-15ms time-to-first-byte (TTFB) while avoiding redundant roundtrips.
Request Authentication Headers
| Header Name | Type | Required | Description |
|---|---|---|---|
| ApiKey | string | Required | Your secret API access key provided upon subscription registration. |
| ApiSecret | string | Required | Your secret API client secret used to sign and authenticate requests. |
Request Parameters
| Parameter | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| pageNumber | query | integer | Optional | 1 | Page index. |
| perPageRow | query | integer | Optional | 20 | Records per page. |
| year | query | integer | Optional | 2026 | Filter year. |
Code Examples
curl -X GET "https://api.ipoapipro.in/api/ipo/all?pageNumber=1&perPageRow=20" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Sample JSON Response
{
"isSuccess": true,
"message": "Successfully.",
"totalRowCount": 112,
"data": [
{
"ipoId": 257,
"companyName": "Shah Investor's Home Ltd",
"displayName": "Shah Investor's Home",
"urlName": "shah-investors-home-ipo",
"symbol": "SHAHINVEST",
"type": "MAINBOARD",
"status": "Closed",
"lotSize": 85,
"minimumPrice": 159,
"maximumPrice": 167,
"minimumInvestment": 14195,
"listingPriceNSE": 182,
"listingGainPercentage": 8.98
},
{
"ipoId": 145,
"companyName": "Avana Electrosystems Ltd",
"displayName": "Avana Electrosystems",
"urlName": "avana-electrosystems-ipo",
"symbol": "AVANA",
"type": "SME",
"status": "Upcoming",
"lotSize": 2000,
"minimumPrice": 56,
"maximumPrice": 59,
"minimumInvestment": 118000,
"listingPriceNSE": null,
"listingGainPercentage": null
}
]
}Response Attributes Schema
| Attribute | Type | Description |
|---|---|---|
| data[].type | string | Designates 'MAINBOARD' or 'SME'. |
| data[].symbol | string | Official exchange ticker symbol (NSE/BSE). |
| data[].lotSize | integer | Minimum shares per application lot. |
| data[].minimumPrice | integer | Floor price band per equity share. |
| data[].maximumPrice | integer | Cap price band per equity share. |
| data[].minimumInvestment | integer | Minimum application value in INR (lotSize * maximumPrice). |
| data[].listingPriceNSE | number | Listing price on NSE if listed. |
| data[].listingGainPercentage | number | Listing gain percentage if listed. |
HTTP Status & Error Codes
| HTTP Code | Title | Condition & Resolution |
|---|---|---|
| 400 | Bad Request | Missing mandatory query parameters, invalid types, or unsupported filter combinations. |
| 401 | Unauthorized | The request lacked valid authentication credentials (ApiKey or ApiSecret). |
| 403 | Forbidden | The subscription plan has expired or this specific endpoint is not included in the plan. |
| 429 | Too Many Requests | Rate limit exceeded. Standard tier permits 60 req/min, Professional tier permits 300 req/min. |
| 500 | Internal Server Error | Downstream exchange connection glitch or upstream registrar network timeout. |
Rate Limits & Edge Caching SLA
Default Rate Limit: 60 requests/minute (Standard) | 300 requests/minute (Pro). Requests are served through Cloudflare edge points of presence across Mumbai, Delhi, Bengaluru, and Chennai with sub-15ms cached latency.
Related IPO API Endpoints
Retrieve paginated listings of Mainboard IPOs with price bands, issue size, timeline, and exchange data.
Stream dedicated BSE SME and NSE Emerge offerings with minimum lot quantities and issue sizes.
Deep-dive company profiles, multi-year financial tables, schedule milestones, and registrar contacts.