Developer API

Every provision of the Constitution, BNS, BNSS, BSA and IPC — plus judgments, amendments, glossary and search — as clean JSON. The only structured, multi-act Indian law API with text verified against official sources.

Authentication

The API is a paid product — every request needs a key from an account with an active plan. Create your key, subscribe, and send it in the x-api-key header (or as a Bearer token):

curl -H "x-api-key: smv_live_..." \
  https://samvidhan.co.in/api/v1/articles/21

Plans

Plan	Price	Requests/day	Requests/min
Developer	₹499/month	10,000	30
Startup	₹2,999/month · commercial use	100,000	120
Bulk licence	Custom — contact us	Full dataset export	—

Building an app? The plans above are for you. They are sized for application traffic — reading the provisions your users actually ask for, as often as they ask.

Want the whole dataset? That is a bulk licence, not a subscription. Keys that sweep the entire corpus are automatically stopped, because a snapshot is not what the API is for — what you are paying for is the live, maintained feed. If you need an export for research or an internal product, write to us — we will licence it properly, with updates.

Endpoints

/api/v1/actsAll five acts with provision counts

/api/v1/acts/{act}One act with chapters and provisions (coi, bns, bnss, bsa, ipc)

/api/v1/articlesConstitution articles (?part=III filters by part)

/api/v1/articles/{number}Full article: text, blocks, explainer, cross-references, judgments, amendments

/api/v1/sections/{act}/{number}Full BNS / BNSS / BSA / IPC section (e.g. /sections/bns/103)

/api/v1/partsParts of the Constitution

/api/v1/parts/{number}One part with its articles

/api/v1/schedulesAll twelve schedules

/api/v1/amendmentsAll constitutional amendments with summaries

/api/v1/judgmentsLandmark cases

/api/v1/judgments/{slug}One case: facts, question, holding, ratio, linked provisions

/api/v1/termsGlossary — constitutionally defined terms and concepts

/api/v1/search?q=Full-text search across everything

/api/v1/metaDataset stats and last sync time

Machine-readable spec: /api/v1/openapi.json. Responses are cached for an hour; quota headers: X-RateLimit-Remaining-Day.

Free embed widget

Writing about a provision? Drop it into your page as an iframe — no API key, no cost, no rate limit. It renders the section, its title and a plain-language one-liner, and links back to the full text. Every provision page also has an Embed button that hands you the snippet.

<iframe src="https://samvidhan.co.in/embed/bns/103"
        width="100%" height="260" loading="lazy"
        style="border:1px solid #e3d9c4;border-radius:16px"></iframe>

Also works for the Constitution (/embed/coi/21) and the BNSS, BSA and IPC. Free to use on any site, commercial or not.

Just need the text, not the API? The full bare acts are free to read and print at /print/{act}, and the printable reference sheets are at /downloads. The API is for querying the corpus programmatically at scale.

Terms

Legal text is public domain. Plain-language layers are AI-assisted (attribution appreciated: “via Samvidhan”). Education, not legal advice — verify critical use against the Legislative Department's official edition.