API Endpoints

Complete reference of all available REST API endpoints.

Base URL:

https://api.ipoguruji.com

All endpoints require authentication via the X-API-Key header. Some endpoints require higher-tier subscription plans. See the Authentication guide for details.

IPO Endpoints

Free+
MethodPathDescription
GET/v1/iposList IPOs with filtering and pagination
GET/v1/ipos/searchSearch IPOs by name
GET/v1/ipos/:slugGet a single IPO by slug
GET/v1/ipos/:slug/subscriptionGet IPO subscription status data
View detailed documentation

GMP Endpoints

Pro+
MethodPathDescription
GET/v1/gmpGet current GMP data for all IPOs
GET/v1/gmp/:ipoSlugGet latest GMP for a specific IPO
GET/v1/gmp/:ipoSlug/historyGet historical GMP data for an IPO
View detailed documentation

NFO Endpoints

Basic+
MethodPathDescription
GET/v1/nfoList NFOs with filtering and pagination
GET/v1/nfo/searchSearch NFOs by name
GET/v1/nfo/:slugGet a single NFO by slug
GET/v1/nfo/amc/:amcCodeList NFOs by AMC code
GET/v1/nfo/amcsList all AMCs
GET/v1/nfo/amcs/:codeGet AMC details by code
View detailed documentation

SGB Endpoints

Basic+
MethodPathDescription
GET/v1/sgbList Sovereign Gold Bonds with pagination
GET/v1/sgb/:idGet a single SGB by ID
View detailed documentation

Other Endpoints

Basic+
MethodPathDescription
GET/v1/rightsList Rights Issues
GET/v1/rights/:idGet a Rights Issue by ID
GET/v1/buybackList Buybacks
GET/v1/buyback/:idGet a Buyback by ID
GET/v1/ncdList NCDs
GET/v1/ncd/:idGet an NCD by ID
GET/v1/ofsList OFS
GET/v1/ofs/:idGet an OFS by ID
GET/v1/plansList subscription plans
GET/v1/usageGet your usage statistics
GET/v1/usage/historyGet usage history
GET/v1/billingGet billing information
POST/v1/billing/subscribeCreate a subscription
POST/v1/billing/cancelCancel a subscription
GET/v1/webhooksList webhooks
POST/v1/webhooksCreate a webhook
PUT/v1/webhooks/:idUpdate a webhook
DELETE/v1/webhooks/:idDelete a webhook
POST/v1/webhooks/:id/testTest a webhook
View detailed documentation

Public Endpoints (No Auth Required)

MethodPathDescription
GET/API information and version
GET/healthHealth check endpoint
GET/disclaimerLegal disclaimer
POST/auth/registerRegister a new user account
POST/auth/loginLogin and obtain session

Response Format

All endpoints return a consistent JSON response structure. For details on pagination, error handling, and rate limits, see: