IPO Guruji - IPO Data API for India

IPO endpoints are available on all plans including the Free tier. They provide access to mainboard and SME IPO data from NSE and BSE, including pricing, dates, subscription status, and listing performance.

GET/v1/ipos

Retrieve a paginated list of IPOs with optional filtering.

Query Parameters

Parameter	Type	Required	Default	Description
`status`	string	Optional	`all`	Filter by IPO status: upcoming, open, closed, listed, withdrawn
`type`	string	Optional	`all`	Filter by IPO type: mainboard, sme
`year`	number	Optional	-	Filter by IPO year (e.g., 2026)
`page`	number	Optional	`1`	Page number for pagination
`limit`	number	Optional	`10`	Number of results per page (max 100)

Example Request

curl -X GET "https://api.ipoguruji.com/v1/ipos?status=open&type=mainboard&limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here"

Success Response200

{
  "success": true,
  "data": [
    {
      "id": "ipo_abc123def456",
      "slug": "nexus-select-trust-reit",
      "name": "Nexus Select Trust REIT IPO",
      "company": "Nexus Select Trust",
      "exchange": "NSE BSE",
      "type": "MAINBOARD",
      "status": "OPEN",
      "issuePrice": { "min": 95, "max": 100 },
      "lotSize": 150,
      "issueSize": "3200.00 Cr",
      "dates": {
        "openDate": "2026-02-10T00:00:00.000Z",
        "closeDate": "2026-02-12T00:00:00.000Z",
        "allotmentDate": "2026-02-15T00:00:00.000Z",
        "listingDate": "2026-02-18T00:00:00.000Z"
      },
      "subscription": {
        "retailTimes": 1.25,
        "niiTimes": 0.85,
        "qibTimes": 2.10,
        "totalTimes": 1.45
      },
      "listing": null,
      "registrar": "KFin Technologies Limited",
      "leadManager": "ICICI Securities, Axis Capital",
      "sector": "Real Estate"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 3,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  },
  "links": {
    "self": "/v1/ipos?status=open&type=mainboard&limit=5&page=1",
    "next": null,
    "prev": null
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_f7k2m9p1x4"
}

GET/v1/ipos/search

Search for IPOs by company name. Returns matching results with relevance ranking.

Query Parameters

Parameter	Type	Required	Default	Description
`q`	string	Required	-	Search query string (minimum 2 characters)
`page`	number	Optional	`1`	Page number for pagination
`limit`	number	Optional	`10`	Number of results per page (max 100)

Example Request

curl -X GET "https://api.ipoguruji.com/v1/ipos/search?q=tata&limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here"

Success Response200

{
  "success": true,
  "data": [
    {
      "id": "ipo_t4t4t3ch2023",
      "slug": "tata-technologies-ltd",
      "name": "Tata Technologies Limited IPO",
      "company": "Tata Technologies Limited",
      "exchange": "NSE BSE",
      "type": "MAINBOARD",
      "status": "LISTED",
      "issuePrice": { "min": 475, "max": 500 },
      "lotSize": 30,
      "issueSize": "3042.51 Cr",
      "dates": {
        "openDate": "2023-11-22T00:00:00.000Z",
        "closeDate": "2023-11-24T00:00:00.000Z",
        "allotmentDate": "2023-11-29T00:00:00.000Z",
        "listingDate": "2023-11-30T00:00:00.000Z"
      },
      "subscription": {
        "retailTimes": 3.79,
        "niiTimes": 4.86,
        "qibTimes": 73.56,
        "totalTimes": 69.43
      },
      "listing": {
        "listingPrice": 1200,
        "listingGain": 140.0,
        "currentPrice": 1050.75
      },
      "registrar": "Link Intime India Private Ltd",
      "leadManager": "JM Financial, Citigroup Global Markets",
      "sector": "Information Technology"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  },
  "links": {
    "self": "/v1/ipos/search?q=tata&limit=5&page=1",
    "next": null,
    "prev": null
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_s3r7h9q2k1"
}

GET/v1/ipos/:slug

Retrieve detailed information for a single IPO by its URL-friendly slug.

Path Parameters

Parameter	Type	Required	Default	Description
`slug`	string	Required	-	URL-friendly slug of the IPO (e.g., tata-technologies-ltd)

Example Request

curl -X GET "https://api.ipoguruji.com/v1/ipos/tata-technologies-ltd" \  -H "X-API-Key: ipg_live_your_api_key_here"

Success Response200

{
  "success": true,
  "data": {
    "id": "ipo_t4t4t3ch2023",
    "slug": "tata-technologies-ltd",
    "name": "Tata Technologies Limited IPO",
    "company": "Tata Technologies Limited",
    "exchange": "NSE BSE",
    "type": "MAINBOARD",
    "status": "LISTED",
    "issuePrice": { "min": 475, "max": 500 },
    "lotSize": 30,
    "issueSize": "3042.51 Cr",
    "dates": {
      "openDate": "2023-11-22T00:00:00.000Z",
      "closeDate": "2023-11-24T00:00:00.000Z",
      "allotmentDate": "2023-11-29T00:00:00.000Z",
      "listingDate": "2023-11-30T00:00:00.000Z"
    },
    "subscription": {
      "retailTimes": 3.79,
      "niiTimes": 4.86,
      "qibTimes": 73.56,
      "totalTimes": 69.43
    },
    "listing": {
      "listingPrice": 1200,
      "listingGain": 140.0,
      "currentPrice": 1050.75
    },
    "registrar": "Link Intime India Private Ltd",
    "leadManager": "JM Financial, Citigroup Global Markets",
    "sector": "Information Technology"
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_d3t4l5p6q7"
}

Not Found Response404

{
  "success": false,
  "error": {
    "code": "NOT_001",
    "message": "IPO not found with slug: nonexistent-ipo",
    "documentation": "https://docs.ipoguruji.com/errors/NOT_001"
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_n0tf0und01"
}

GET/v1/ipos/:slug/subscription

Retrieve detailed subscription status data for a specific IPO, broken down by investor category.

Path Parameters

Parameter	Type	Required	Default	Description
`slug`	string	Required	-	URL-friendly slug of the IPO

Example Request

curl -X GET "https://api.ipoguruji.com/v1/ipos/nexus-select-trust-reit/subscription" \  -H "X-API-Key: ipg_live_your_api_key_here"

Success Response200

{
  "success": true,
  "data": {
    "ipoSlug": "nexus-select-trust-reit",
    "ipoName": "Nexus Select Trust REIT IPO",
    "status": "OPEN",
    "subscription": {
      "retail": {
        "category": "Retail Individual Investors (RII)",
        "subscriptionTimes": 1.25,
        "applicationsReceived": 245000,
        "sharesOffered": 3200000,
        "sharesApplied": 4000000
      },
      "nii": {
        "category": "Non-Institutional Investors (NII)",
        "subscriptionTimes": 0.85,
        "applicationsReceived": 12400,
        "sharesOffered": 1600000,
        "sharesApplied": 1360000
      },
      "qib": {
        "category": "Qualified Institutional Buyers (QIB)",
        "subscriptionTimes": 2.10,
        "applicationsReceived": 85,
        "sharesOffered": 4800000,
        "sharesApplied": 10080000
      },
      "total": {
        "subscriptionTimes": 1.45,
        "sharesOffered": 9600000,
        "sharesApplied": 15440000
      }
    },
    "lastUpdated": "2026-02-10T15:30:00.000Z"
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-10T15:30:00.000Z",
  "requestId": "req_s6b7s8c9r0"
}

IPO Object Reference Pagination GMP Endpoints

IPO Endpoints

Query Parameters

Query Parameters

Path Parameters

Path Parameters

Related Pages