Skip to main content

IPO Application APIs Beta

Effective Date: August 14, 2026

Four new endpoints extend the IPO APIs from read-only discovery to full application management. You can now apply for an open IPO, track the resulting application through allotment, and withdraw it while bidding is still open.

For the full endpoint reference and sample code, see the IPO API documentation.

What's new​

Apply for IPO​

Submit an IPO application with one to three bids. The application amount is blocked through a UPI mandate that the applicant approves in their UPI app.

  • Endpoint: POST /v2/ipos/orders
  • Documentation: Apply IPO

Get IPO Orders​

Retrieve a paginated list of the account's IPO applications, including bids, mandate state, exchange submission timestamps, and allotment quantity.

Get IPO Order Details​

Fetch a single application by its order_id — useful for polling one application after submitting it.

Cancel IPO Order​

Withdraw an application and release the UPI mandate that blocks the amount in the applicant's bank account.

Application workflow​

For a step-by-step walkthrough of applying to an IPO — finding an open IPO, reading its bidding rules, submitting the application, and approving the UPI mandate — see Apply IPO.

Application status reference​

Three fields describe where an application stands. The full tables live on Get IPO Orders.

FieldValues
statusawaiting_mandate, ipo_allotted, ipo_not_allotted, application_deleted
order_statussuccess, allotted, not_allotted
payment_statuspending, mandate_accepted

These fields are returned as free-form strings rather than fixed enums, so handle unrecognised values gracefully.

Thank you​

We appreciate your continued support. If you have questions or feedback, reach out through the developer community.