Developer Integration Hub

Build with Sovereign Trust

Connect your institutional infrastructure directly to the NIA National Identity Registry via our production-grade, RESTful API gateway.

API Governance

POST /v1/verify

Initiates the verification lifecycle by generating a sovereign digital token and notifying the identity owner via SMS.

Request Payload

{
  "ghana_card_no": "GHA-712219349-4",
  "mobile_number": "0240001111",
  "callback_url": "https://yourserver.com/nia-webhook",
  "requested_by": "POS_TERMINAL_01"
}

GET /v1/check-status

Retrieves the gated verification result. Data returned is pruned based on your node's assigned security permissions.

Success Payload (IDENTIFICATION + TRUST)

{
  "status": "success",
  "data": {
    "transactionGuid": "NIA-8D92A...",
    "verified": "TRUE",
    "person": {
      "nationalId": "GHA-712219349-4",
      "surname": "MENSAY",
      "forenames": "KWAME",
      "birthDate": "1983-07-08",
      "cardId": "GH9837208",
      "cardValidTo": "2028-12-11"
    }
  }
}

Webhook Implementation

Activate real-time notification node. When a verification cycle completes, NIA Sovereign Node initiates a POST request to your `callback_url` with the gated result payload.

Provide a TLS (HTTPS) endpoint.

Production Base URL

https://api.nia.gov.gh/v1

Always authenticate using X-Client-ID and X-Client-Secret headers for every transaction.

Need Enterprise Support?

For high-throughput integrations (over 10,000 requests/sec) or specialized private node deployments, contact our technical sovereign governance team.

support@nia.gov.gh