Application-Wise IPO Bidding API - Real-Time Bid Counts
Returns granular application-level bidding data across all SEBI investor categories (Retail, Small HNI ₹2L-₹10L, Big HNI >₹10L, QIB, Employees, and Shareholders). Crucial for calculating lottery odds and oversubscription probabilities before allotment.
Endpoint Overview & Architecture
While share subscription multiples represent the volume of shares applied for versus shares offered, Application-Wise Subscription reveals the actual count of individual application forms submitted across banking ASBA channels and stock brokers.
Under SEBI retail allotment guidelines, retail shares are not allotted pro-rata; instead, each successful retail applicant receives exactly one minimum lot via an electronic randomized lottery. Because of this rule, calculating true retail allotment odds requires knowing the exact number of valid applications submitted versus maximum available retail lots.
This endpoint feeds institutional risk desks and retail investor portals with precise application volumes for Retail, sNII, and bNII categories, enabling users to evaluate competition intensity before the bidding cutoff.
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 |
|---|---|---|---|---|---|
| ipoId | path | integer | Required | - | Target IPO unique ID (e.g. 257). |
Code Examples
curl -X GET "https://api.ipoapipro.in/api/ipo/appwise-subscription/257" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Sample JSON Response
{
"isSuccess": true,
"message": "Successfully.",
"lastUpdated": "2026-09-30T13:00:00.000Z",
"data": {
"retailSubscription": 3.74,
"niiSubscription": 18.01,
"bniiSubscription": 19.19,
"sniiSubscription": 15.65,
"qibSubscription": 4.49,
"employeeSubscription": null,
"shareHolderSubscription": null,
"retailApplication": 124525,
"niiApplication": 6070,
"bniiApplication": 1840,
"sniiApplication": 4230,
"qibApplication": null,
"employeeApplication": null,
"shareHolderApplication": null,
"lastUpdate": "2026-09-30T13:00:00.000Z"
}
}Response Attributes Schema
| Attribute | Type | Description |
|---|---|---|
| data.retailApplication | integer | Total valid applications submitted in the Retail category. |
| data.bniiApplication | integer | Applications received in Big HNI / bNII quota (>₹10 Lakhs). |
| data.sniiApplication | integer | Applications received in Small HNI / sNII quota (₹2L - ₹10L). |
| data.qibApplication | integer | Total institutional applications received (QIB bids). |
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
Up-to-the-minute subscription multiples (times subscribed) per investor category and total bids.
Master subscription feed combining share bids, application counts, lottery winner odds (PeopleBase), and narrative AI summaries.
Direct registrar Basis of Allotment (BoA) official documents and allotment ratios by year and board type.