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.