API INFRASTRUCTURE

The Institutional
Identity Layer.

Powering the next generation of high-trust business workflows in Bharat. Resolve identities, search granular business registries, and verify compliance with zero-trust architecture.

Interactive API Console
Live Engine (5 Req/3m)

Identity Resolution & Shield

Submit unverified fragments to the BBIE Confidence Engine.

Sovereignty Shield
Request Payload Previewapplication/json
{
  "entity_name": "Mphasis",
  "pincode": "560001",
  "pan": "BLRMP1234F",
  "gstin": "29BLRMP1234F1Z5",
  "address": "Bagmane World Technology Center, Mahadevapura",
  "sovereignty_mask": true
}

Playground Ready for Execution

Configure the parameters above and click Execute to test institutional latency, zero-trust masking, and rate limiting (5 req/3m).

Core API Reference

Standardized endpoints for institutional data consumption.

Identity Resolution

Submit raw business signals (Name, Address, GSTIN) and receive a high-confidence UBID resolution.

POST /v1/resolve
Parameters
entity_namestring

Required. The name of the business entity.

pincodestring

Highly Recommended. The primary 6-digit PIN code.

sovereignty_maskboolean

Optional. If true, returns hashed PII tokens.

Business Search

Search the national registry by name, pincode, tax PAN, GSTIN, or sector when UBID is unknown.

GET /v1/business
Parameters
namestring

Optional. Partial or exact business entity name.

pincodestring

Optional. 6-digit postal area code.

panstring

Optional. 10-character Tax PAN identifier.

gstinstring

Optional. 15-character GST registration ID.

sectorstring

Optional. Industry sector category.

Dossier Retrieval

Fetch the comprehensive National System of Record for any business using its unique UBID identifier.

GET /v1/business/:ubid
Parameters
ubidstring

Required. The Unique Bharat Business ID.

include_auditboolean

Optional. Include the forensic resolution timeline.

Institutional Safeguards

Our API is built on the **Sovereignty Shield** architecture. Every request is scrubbed of PII in the buffer layer, and matching occurs exclusively on forensic hashes.

TLS 1.3 Encryption

In-transit sovereignty

Zero-Trust Auth

Role-based dossier access

# Institutional Header Example
X-BBIE-TOKEN: INSTITUTION_HASH_771
X-SOVEREIGNTY-MODE: FULL_MASK
X-TIMESTAMP: 2026-05-16T13:30:07Z
BBIE API HUB

© 2026 National Business Intelligence Engine