IG
IPO Guruji

Other Endpoints

Rights Issues, Buyback, NCD, OFS, Plans, Usage, Billing, and Webhook endpoints.

Rights Issues

Rights issues allow existing shareholders to purchase additional shares at a discounted price.

GET/v1/rightsBasic+

Retrieve a paginated list of rights issues.

Query Parameters

ParameterTypeRequiredDefaultDescription
pagenumberOptional1Page number for pagination
limitnumberOptional10Number of results per page (max 100)
GET/v1/rights/:idBasic+

Retrieve a specific rights issue by its ID.

Path Parameters

ParameterTypeRequiredDefaultDescription
idstringRequired-Unique identifier of the rights issue
Example Request
curl -X GET "https://api.ipoguruji.com/v1/rights?limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here"
Success Response200
{
  "success": true,
  "data": [
    {
      "id": "rights_abc123",
      "companyName": "Tata Steel Limited",
      "issuePrice": 200,
      "ratio": "1:5",
      "ratioDescription": "1 new share for every 5 shares held",
      "recordDate": "2026-01-15T00:00:00.000Z",
      "openDate": "2026-02-05T00:00:00.000Z",
      "closeDate": "2026-02-19T00:00:00.000Z",
      "issueSize": "1250.00 Cr",
      "status": "open",
      "exchange": "NSE BSE"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 3,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  },
  "links": {
    "self": "/v1/rights?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_r1g2h3t4s5"
}

Buyback

Buyback (share repurchase) data for companies buying back their own shares from existing shareholders.

GET/v1/buybackBasic+

Retrieve a paginated list of buyback offers.

Query Parameters

ParameterTypeRequiredDefaultDescription
pagenumberOptional1Page number for pagination
limitnumberOptional10Number of results per page (max 100)
GET/v1/buyback/:idBasic+

Retrieve a specific buyback offer by its ID.

Path Parameters

ParameterTypeRequiredDefaultDescription
idstringRequired-Unique identifier of the buyback
Example Request
curl -X GET "https://api.ipoguruji.com/v1/buyback?limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here"
Success Response200
{
  "success": true,
  "data": [
    {
      "id": "buyback_xyz789",
      "companyName": "Infosys Limited",
      "buybackPrice": 1850,
      "marketPrice": 1700,
      "premium": 8.82,
      "buybackSize": "9300.00 Cr",
      "maxShares": 50270270,
      "recordDate": "2026-01-20T00:00:00.000Z",
      "openDate": "2026-02-03T00:00:00.000Z",
      "closeDate": "2026-02-17T00:00:00.000Z",
      "status": "open",
      "method": "Tender Offer",
      "exchange": "NSE BSE"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 2,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  },
  "links": {
    "self": "/v1/buyback?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_b1y2b3k4c5"
}

NCD (Non-Convertible Debentures)

Non-Convertible Debentures are fixed-income instruments that cannot be converted into equity shares.

GET/v1/ncdBasic+

Retrieve a paginated list of NCD issues.

Query Parameters

ParameterTypeRequiredDefaultDescription
pagenumberOptional1Page number for pagination
limitnumberOptional10Number of results per page (max 100)
GET/v1/ncd/:idBasic+

Retrieve a specific NCD issue by its ID.

Path Parameters

ParameterTypeRequiredDefaultDescription
idstringRequired-Unique identifier of the NCD
Example Request
curl -X GET "https://api.ipoguruji.com/v1/ncd?limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here"

OFS (Offer for Sale)

Offer for Sale is a mechanism for promoters of listed companies to sell shares through the exchange platform.

GET/v1/ofsBasic+

Retrieve a paginated list of OFS events.

Query Parameters

ParameterTypeRequiredDefaultDescription
pagenumberOptional1Page number for pagination
limitnumberOptional10Number of results per page (max 100)
GET/v1/ofs/:idBasic+

Retrieve a specific OFS event by its ID.

Path Parameters

ParameterTypeRequiredDefaultDescription
idstringRequired-Unique identifier of the OFS
Example Request
curl -X GET "https://api.ipoguruji.com/v1/ofs?limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here"

Plans and Billing

Endpoints for managing your subscription plan and billing information.

GET/v1/plans

List all available subscription plans with their features and pricing.

Example Request
curl -X GET "https://api.ipoguruji.com/v1/plans" \  -H "X-API-Key: ipg_live_your_api_key_here"
Success Response200
{
  "success": true,
  "data": [
    {
      "id": "plan_free",
      "name": "Free",
      "price": 0,
      "currency": "INR",
      "interval": "month",
      "requestsPerMinute": 10,
      "requestsPerDay": 100,
      "features": ["IPO data", "Search", "Basic filters"],
      "gmpAccess": false,
      "nfoAccess": false,
      "sgbAccess": false,
      "webhooksLimit": 0
    },
    {
      "id": "plan_basic",
      "name": "Basic",
      "price": 499,
      "currency": "INR",
      "interval": "month",
      "requestsPerMinute": 60,
      "requestsPerDay": 1000,
      "features": ["All Free features", "NFO data", "SGB data", "Rights/Buyback/NCD/OFS"],
      "gmpAccess": false,
      "nfoAccess": true,
      "sgbAccess": true,
      "webhooksLimit": 0
    },
    {
      "id": "plan_pro",
      "name": "Pro",
      "price": 1499,
      "currency": "INR",
      "interval": "month",
      "requestsPerMinute": 200,
      "requestsPerDay": 10000,
      "features": ["All Basic features", "GMP data", "GMP history", "Webhooks"],
      "gmpAccess": true,
      "nfoAccess": true,
      "sgbAccess": true,
      "webhooksLimit": 5
    },
    {
      "id": "plan_enterprise",
      "name": "Enterprise",
      "price": 4999,
      "currency": "INR",
      "interval": "month",
      "requestsPerMinute": 1000,
      "requestsPerDay": 100000,
      "features": ["All Pro features", "Priority support", "20 webhooks", "Custom integrations"],
      "gmpAccess": true,
      "nfoAccess": true,
      "sgbAccess": true,
      "webhooksLimit": 20
    }
  ],
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_p1l4n5l6s7"
}
GET/v1/billing

Get your current billing and subscription information.

POST/v1/billing/subscribe

Create or upgrade a subscription. Integrates with Razorpay for payment processing.

Request Body

ParameterTypeRequiredDefaultDescription
planIdstringRequired-The plan ID to subscribe to (e.g., plan_basic, plan_pro)
POST/v1/billing/cancel

Cancel your current subscription. Access continues until the end of the billing period.

Usage

Monitor your API usage and quota consumption.

GET/v1/usage

Get your current usage statistics including requests made, quota remaining, and rate limit status.

Example Request
curl -X GET "https://api.ipoguruji.com/v1/usage" \  -H "X-API-Key: ipg_live_your_api_key_here"
Success Response200
{
  "success": true,
  "data": {
    "plan": "Pro",
    "period": {
      "start": "2026-02-01T00:00:00.000Z",
      "end": "2026-02-28T23:59:59.000Z"
    },
    "usage": {
      "requestsToday": 450,
      "requestsThisMinute": 12,
      "dailyLimit": 10000,
      "minuteLimit": 200,
      "dailyRemaining": 9550,
      "minuteRemaining": 188
    },
    "totalRequestsThisMonth": 8500
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_u1s2a3g4e5"
}
GET/v1/usage/history

Get historical usage data for previous billing periods.

Webhooks

Manage webhook endpoints for real-time event notifications. For a complete guide on setting up and using webhooks, see the Webhooks guide.

GET/v1/webhooksPro+

List all configured webhook endpoints.

POST/v1/webhooksPro+

Create a new webhook endpoint.

Request Body

ParameterTypeRequiredDefaultDescription
urlstringRequired-The HTTPS URL to receive webhook events
eventsstring[]Required-Array of event types to subscribe to (e.g., ipo.opened, ipo.listed, gmp.updated)
secretstringOptional-Shared secret for signature verification (auto-generated if not provided)
PUT/v1/webhooks/:idPro+

Update an existing webhook endpoint.

Path Parameters

ParameterTypeRequiredDefaultDescription
idstringRequired-Webhook endpoint ID
DELETE/v1/webhooks/:idPro+

Delete a webhook endpoint.

POST/v1/webhooks/:id/testPro+

Send a test event to a webhook endpoint to verify it is receiving events correctly.

Related Pages

Webhooks GuideRate LimitsPricing Plans
NextIntroduction