Boundary
Overview
The Boundary V2 separates location boundaries into distinct hierarchies in the Citizen Complaints Resolution System on DIGIT.
REVENUE-LOCALITY
Urban boundary data (Cities, ULBs)
This helps the system route complaints more accurately based on whether they belong to urban or rural areas.
Services Required
To use Boundary V2 in your environment, the following DIGIT microservices must be deployed and running:
boundary-bulk-bff
Handles bulk upload of boundaries
boundary-service-db
Stores and manages boundary data
Release Update Highlights
Location boundaries are now handled via two separate hierarchies.
Enables better service routing and area-specific workflows.
Supports bulk creation and Excel-based uploads for managing boundaries easily.
Pre-requisites
Before starting, make sure the following are ready:
✅ Postman is installed
✅ Your DIGIT app base URL (e.g.,
https://dev.digit.org
)✅ AuthToken of a superuser (from installation)
✅ The target
tenantId
where the boundary is to be set (e.g.,pg.citya
)
Configure Boundary
Import Postman Collection
Copy the provided Postman collection URL.
Open Postman.
Click the Import icon.
Paste the URL and click Continue → Import.
The collection will now appear on the left side in Postman.
Before running any APIs, update your Postman environment with:
baseUrl
= your DIGIT app domain (e.g.,https://dev.digit.org
)
authToken
= superuser token
tenantId
= state + city ULB (e.g.,pg.citya
)
Sample Reference Files
✅ locality.xlsx – Urban boundaries
(Provide internal links or shareable URLs if hosting these templates in your internal system.)
Summary
1
Create boundary hierarchy
/boundary-service/boundary-hierarchy-definition/_create
2
Generate Excel template
/boundary-bulk-bff/v1/boundary/generate
3
Download the template
/filestore/v1/files/url
4
Fill Excel with boundary data
Use Excel locally
5
Upload filled file
/filestore/v1/files
6
Create boundaries from the file
/boundary-bulk-bff/v1/boundary/createw4
Tips
Always use the correct tenantId (e.g., pb, uk, as) across all requests.
Don’t modify the template structure when filling in the Excel.
If the hierarchy already exists, you can skip Step 1.
If you encounter errors during boundary creation, check:
Hierarchy names are consistent
Excel fields are not empty
Uploaded Excel matches template format
Last updated
Was this helpful?