🇳🇵 Nepal Entity Service

Open Source, open data, and open API for Nepali public entities

Welcome to the Nepal Entity Service (NES) documentation. 🇳🇵 NES is an Open Source, open data, and open API project that provides a comprehensive platform for managing Nepali public entities including persons, organizations, and locations with full versioning and relationship tracking.

Open Source • Open Data • Open API

Nepal Entity Service is built on three core principles:

Entities hosted

Currently offering

  1. Location data
    1. 7 Provinces
    2. 77 Districts
    3. 165 constituencies
    4. 460 Rural municipalities (VDCs)
    5. 11 Sub-metropolitician cities
    6. 6 Municipalities
    7. 6,743 wards
  2. Political Parties
    1. 124 registered political parties (Official NEC data from Kartik 2082)
  3. Politicians
    1. 7,744 party candidates from 2079 B.S. national and provincial elections.
  4. Health Facilities
    1. 11,399 hospitals and health facilities from Nepal Health Facility Registry (NHFR)

Near future plans

  1. Incorporate newly registered political parties
  2. Incorporate government bodies of all levels
  3. Incorporate current government leaders, and Nepali bureaucrats

Documentation Index

For API Consumers

Start here if you want to use the public Nepal Entity Service API:

For Contributors

Start here if you want to contribute to the project or run your own instance:

Data Maintenance & Migrations

For contributors who manage data and migrations:

Service Guides

Detailed guides for using the core services:

Specifications

Technical specifications and design documents:

All Documentation Files

Consumer Documentation

Contributor Documentation

What is Nepal Entity Service?

The Nepal Entity Service provides a robust foundation for civic technology applications, built from the ground up with multilingual support and a deep commitment to respecting Nepali culture in software. The service offers:

Key Features

Entity Management

Manage three types of entities with rich metadata:
- Persons: Politicians, public officials, and other public figures
- Organizations: Political parties, government bodies, NGOs
- Locations: Provinces, districts, municipalities, and wards

Versioning and Audit Trails

Every change to entities and relationships is tracked with:
- Complete snapshots of previous states
- Author attribution and timestamps
- Change descriptions for transparency
- Historical state retrieval

Relationship System

Model complex connections between entities:
- Typed relationships (MEMBER_OF, AFFILIATED_WITH, EMPLOYED_BY, etc.)
- Temporal relationships with start and end dates
- Bidirectional relationship queries
- Relationship versioning

Multilingual Support & Cultural Respect

Built from the ground up to honor Nepal's linguistic and cultural context:
- Native Nepali Support: First-class support for Nepali (Devanagari) script alongside English
- Proper Name Handling: Authentic representation of Nepali names without forcing Western conventions
- Transliteration & Romanization: Accurate conversion between scripts while preserving meaning
- Cross-Language Search: Query entities in either Nepali or English seamlessly
- Cultural Context Preservation: Maintain authenticity to Nepali political, social, and organizational structures
- Respectful Software Design: Every aspect of the service is designed to respect and celebrate Nepali culture, not just accommodate it

API Overview

The Nepal Entity Service provides a public read-only API for accessing entity data:

GET /api/entities              # Search and list entities
GET /api/entities/{id}         # Get specific entity
GET /api/relationships         # Query relationships
GET /api/entities/{id}/versions # Get version history
GET /api/schemas               # Discover entity types
GET /api/health                # Health check

All API endpoints are documented in the interactive OpenAPI documentation.

Use Cases

The Nepal Entity Service is designed for:

Getting Started

Ready to start using the Nepal Entity Service? Check out the Getting Started guide for installation instructions and your first API calls.

Project Status

Nepal Entity Service v2 is currently in active development as an open source, open data initiative.

Open Access

Open Contributions

License and Contributing

This project is licensed under the Hippocratic License 3.0, an ethical source license that grants broad permissions to use, modify, and distribute the software, with one important condition: the software must not be used in ways that violate human rights laws or principles as defined by the United Nations Universal Declaration of Human Rights.

What This Means

Why This License?

The Nepal Entity Service manages data about public figures and organizations. We chose the Hippocratic License to:

The license is designed to be permissive for legitimate uses while establishing clear ethical boundaries.

Contributing

We welcome contributions from everyone who shares our commitment to ethical technology:

For more information about contributing, see our Contributor Guide or visit our GitHub repository.

Full License Text

The complete Hippocratic License 3.0 text is available in the LICENSE file in the repository. For more information about the Hippocratic License, visit firstdonoharm.dev.

Need Help? Check out our Examples page for common usage patterns, or explore the OpenAPI documentation for detailed endpoint documentation.