IPO Data JSON API - Deep Company Financials & DRHP
The master detail endpoint returning full corporate profile, prospectus links (DRHP/RHP), anchor investor summaries, complete financial balance sheet & P&L metrics, objects of issue, timeline schedule, and registrar details.
Endpoint Overview & Architecture
The Comprehensive IPO Details API endpoint acts as the single source of truth for all qualitative and audited quantitative data surrounding an initial public offering in India. While list endpoints provide basic price and date coordinates, this endpoint returns complete company intelligence necessary for institutional due diligence.
Key fields include multi-year balance sheet and profit-and-loss tables (Revenue, EBITDA, PAT, Net Worth, Total Borrowings), promoter shareholding pre and post-issue, objects of the issue (e.g. debt repayment, capital expenditure, general corporate purposes), designated Book Running Lead Managers (BRLMs), and assigned share transfer registrars with verified customer support email and tracking portal URLs.
Additionally, this endpoint provides direct verified links to the official Draft Red Herring Prospectus (DRHP) and Red Herring Prospectus (RHP) filed with SEBI, making it a critical backend component for fintech platforms and stock broking research desks.
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 | - | Unique integer ID of the IPO. |
Code Examples
curl -X GET "https://api.ipoapipro.in/api/ipo/details/257" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Sample JSON Response
{
"isSuccess": true,
"message": "Successfully.",
"data": {
"ipoId": 257,
"companyName": "Shah Investor's Home Ltd",
"displayName": "Shah Investor's Home",
"urlName": "shah-investors-home-ipo",
"symbol": "SHAHINVEST",
"scriptCode": "544123",
"companyLogo": "https://api.ipoapipro.in/upload/ipodata/logo/shah-investor-s-home-logo.jpg",
"type": "MAINBOARD",
"minimumPrice": 159,
"maximumPrice": 167,
"faceValue": 10,
"lotSize": 85,
"minimumInvestment": 14195,
"listingPriceNSE": 182,
"listingPriceBSE": 181.5,
"listingGainPercentage": 8.98,
"freshIssuePrice": "₹90.17 Cr",
"freshIssueShares": 5400000,
"ofsIssuePrice": null,
"ofsIssueShares": null,
"totalIssuePrice": "₹90.17 Cr",
"timeLine": {
"startDate": "2026-09-28",
"endDate": "2026-09-30",
"allotmentDate": "2026-10-01",
"refundDate": "2026-10-05",
"creditShareDate": "2026-10-05",
"listingDate": "2026-10-06"
},
"strength": "<ul><li>Established presence in retail and institutional financial brokerage.</li><li>Diversified revenue streams spanning equity broking, depository services, and wealth management.</li><li>Experienced leadership team with extensive capital market track record.</li></ul>",
"risk": "<ul><li>Revenues significantly dependent on broader Indian stock market trading volumes.</li><li>Stringent regulatory supervision from SEBI and capital market compliance requirements.</li><li>Intense competition from zero-brokerage discount fintech brokers.</li></ul>",
"valuation": [
{
"Key": "P/E (Pre-IPO)",
"Value": "24.50"
},
{
"Key": "P/E (Post-IPO)",
"Value": "27.80"
},
{
"Key": "EPS Pre-IPO",
"Value": "₹6.82"
},
{
"Key": "RoNW (%)",
"Value": "19.20%"
},
{
"Key": "ROCE (%)",
"Value": "22.80%"
},
{
"Key": "Debt/Equity",
"Value": "0.45"
}
],
"registrar": {
"name": "Link Intime India Private Ltd",
"email": "[email protected]",
"ipoEmail": "[email protected]",
"phone": "+91-22-49186270",
"website": "https://linkintime.co.in",
"allotmentUrl": "https://linkintime.co.in/initial_offer/public-issues.html",
"address": "C 101, 247 Park, L.B.S. Marg, Vikhroli (West), Mumbai 400083"
}
}
}Response Attributes Schema
| Attribute | Type | Description |
|---|---|---|
| data.symbol | string | Official exchange ticker symbol (NSE/BSE). |
| data.scriptCode | string | BSE scrip code. |
| data.minimumInvestment | integer | Minimum application value in INR (lotSize * maximumPrice). |
| data.listingPriceNSE | number | Official listing day opening price on NSE. |
| data.listingPriceBSE | number | Official listing day opening price on BSE. |
| data.listingGainPercentage | number | Listing day percentage gain/loss against issue price. |
| data.freshIssuePrice | string | Total issue size allocated for fresh capital raising. |
| data.ofsIssuePrice | string | Total issue size representing Offer for Sale by promoters/existing shareholders. |
| data.timeLine | object | Standard SEBI timeline milestone dates (YYYY-MM-DD). |
| data.strength | string (HTML) | HTML list of qualitative company competitive strengths scraped from Bajaj Broking. |
| data.risk | string (HTML) | HTML list of qualitative business and market risks scraped from Bajaj Broking. |
| data.valuation | array (objects) | Structured key-value financial KPI ratios including P/E (Pre/Post), RoNW, ROCE, EPS, and Debt/Equity. |
| data.registrar | object | Designated share transfer registrar contact info including phone, IPO email, and direct allotment query URL. |
| data.financialInformation | string (HTML) | Audited multi-year financial tables (Revenue, PAT, EBITDA, Net Worth). |
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.
Share allocation breakdown by investor category (Retail, QIB, NII/HNI, Anchor, Employee).
Up-to-the-minute subscription multiples (times subscribed) per investor category and total bids.
Direct registrar Basis of Allotment (BoA) official documents and allotment ratios by year and board type.