NPS Docs
The central repository of NPS technical and general documents. Each document keeps a permanent link and always shows its latest version.
Technical documents
Account Information – Status, profile, portfolio, returns and transactions
The eight read APIs for an existing subscriber's accounts — what each returns, how partial results from several CRAs are reported, and how to page and filter.
Audience: Registered partners (points of presence)
v1.0FinalUpdated 12/10/2026Authentication – Client secret with subject assertion
How a point of presence registered with a client secret obtains an access token, opens a session for an existing subscriber on its own signed assertion, and manages that session.
Audience: Registered partners (points of presence)
v1.0FinalUpdated 12/10/2026Modifications – Changing an existing subscriber's details
How a partner checks, submits, follows, acknowledges and cancels changes to an existing subscriber's contact details, address, bank accounts, nominees, marital status, FATCA declaration and Tier II.
Audience: Registered partners (points of presence)
v1.0FinalUpdated 12/10/2026NPS Swasthya – HBA API Contract
The eligibility, balance and withdrawal API contract every Health Benefit Administrator (HBA) implements to check NPS Swasthya eligibility, read the eligible balance and raise a withdrawal through NPS Central. It also fixes the common transport, security, data and error standards.
Audience: Health Benefit Administrators (HBAs)
v1.0DraftUpdated 21/10/2026NPS Swasthya – Standard API Specifications & Integration Contracts
The API contract every participating Insurance Company implements for NPS Swasthya: premium calculation, policy issuance and policy information retrieval. It also fixes the common security, data and error standards that apply to all of them.
Audience: Participating Insurance Companies
v1.0 Draft 3DraftUpdated 14/10/2026Payload Encryption – The NPSC envelope
How a partner encrypts request bodies and decrypts response bodies with the NPSC envelope, with test vectors to check an implementation against.
Audience: Registered partners (points of presence)
v1.0FinalUpdated 12/10/2026