Skip to content
NEPALNEXT
Nepal Next, Civic Intelligence
Menu
SearchSign inReport Issue

Nepal Next · API · for newsrooms, researchers, civic tech

Cite our data,
programmatically.

Every cited dataset on Nepal Next — leadership scorecards, government notices, citizen polls, national debt and aid, international indices, and citizen-reported local issues — is a public JSON or CSV endpoint. No key required. Open CORS. Attribution requested under CC BY 4.0. Build a newsroom dashboard, a research pipeline, or your own civic tool on top of it.

Quick start

# discover every dataset in one call

curl https://nepalnext.com/api/v1

# leadership scorecards as JSON

curl https://nepalnext.com/api/v1/leaders

# same data as CSV for spreadsheets

curl https://nepalnext.com/api/v1/leaders?format=csv

# one profile in full

curl https://nepalnext.com/api/v1/leaders/balen-shah

All responses are wrapped in { "_meta": { … }, "data": … } where _meta carries publisher, license, generation time, and a link back to the live verification snapshot.

Discovery

  • GET/api/v1

    API catalog — every dataset with a live row count. The one call that discovers the whole surface.

  • GET/api/v1/openapi.json

    OpenAPI 3.1 description for Swagger UI, Postman, code generators, and agents.

/leaders — leadership scorecards

  • GET/api/v1/leadersalso CSV via ?format=csv

    Leadership directory with panel-reviewed scorecards. Filter by ?layer= ?party= ?province= ?limit=. A composite score appears only where one has been published; otherwise scoreStatus is "assessment_underway".

  • GET/api/v1/leaders/{slug}

    One profile in full — biography, promises vs delivery, controversies, political journey, cited source evidence, and the scorecard with per-dimension breakdown.

Notices, polls, and citizen issues

  • GET/api/v1/noticesalso CSV via ?format=csv

    Published government notices, each linked to its official source and archived copy. Filter by ?category= ?ministry= ?limit=.

  • GET/api/v1/pollsalso CSV via ?format=csv

    Citizen polls (active or closed) with live tallies and per-option vote share.

  • GET/api/v1/issuesalso CSV via ?format=csv

    Citizen-reported local issues (Gunaso) that cleared moderation. Filter by ?district= ?category= ?resolved=. Reporter identity is never included.

Gunasoissues are moderated before publication; the API serves only what cleared review, and never a reporter’s name or contact.Poll tallies are live and update on every read.

/desh — national accountability board

  • GET/api/v1/desh/summary

    Everything for /desh in one shot — projects, donors, lenders, contractors, debt snapshot, verification status.

  • GET/api/v1/desh/megaprojectsalso CSV via ?format=csv

    List of every cited megaproject.

  • GET/api/v1/desh/megaprojects/{slug}

    One megaproject by slug.

  • GET/api/v1/desh/donorsalso CSV via ?format=csv

    List of cited foreign aid donors.

  • GET/api/v1/desh/donors/{slug}

    One donor by slug.

  • GET/api/v1/desh/lendersalso CSV via ?format=csv

    External creditors and aggregate public-debt snapshot.

  • GET/api/v1/desh/lenders/{slug}

    One lender by slug.

  • GET/api/v1/desh/contractorsalso CSV via ?format=csv

    Government contractor ledger.

  • GET/api/v1/desh/contractors/{slug}

    One contractor by slug.

  • GET/api/v1/desh/verify

    Latest source-drift and adversarial-review snapshot.

/world — international standing

  • GET/api/v1/world/indicesalso CSV via ?format=csv

    Every international index Nepal is ranked on — current value, rank, tier, source.

  • GET/api/v1/world/indices/{slug}

    One index in full (with sub-indicators, peer comparison, history).

Conventions

Stable v1 contract

Additive changes only. Breaking changes go to /api/v2. Field renames are deprecations, never silent removals.

Open CORS

All endpoints respond Access-Control-Allow-Origin: *. Fetch from any origin, no key.

Caching

Cache-Control: public, s-maxage=86400, stale-while-revalidate=604800. Strong ETag on every JSON response — use conditional GETs.

Verification trail

Every response includes a verifyUrl in _meta pointing at /api/v1/desh/verify. Use it to attach a freshness timestamp to any republished Nepal Next number.

CSV format

List endpoints accept ?format=csv. UTF-8, quoted where necessary, returned with the right filename in Content-Disposition.

License

CC BY 4.0. Use Nepal Next data anywhere — newsroom story, dashboard, research paper, civic-tech tool — with attribution. The expected form:

“Source: Nepal Next (nepalnext.com/desh), verified against [primary publisher].”

We re-verify every cited source daily and adversarially review headline claims weekly. Read the verification methodology or hit /api/v1/desh/verify for the current snapshot.

Working with this data?

We'd like to know. If your newsroom, dashboard, or research project is built on this API, tell us at social@nepalnext.com— we'll link to your work from this page and prioritise the dataset additions you care about.

For corrections or disputes, email hello@nepalnext.com or open an issue via /contact.