Share Code

The NIMC mobile app lets the cardholder generate a temporary 6-character share code. Pass the code to this endpoint to retrieve their record without ever handling the raw NIN.

POST/verify-nin/share-code

Request

Field	Type	Required	Notes
share_code	string	✅	6 characters, alphanumeric, uppercase (the API uppercases it for you)
reason	string	✅	A key from /nimc-reasons

curl

curl -X POST https://api.randaverify.com/verify-nin/share-code \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "share_code": "AB12CD",
    "reason": "corporate"
  }'

Python

resp = requests.post(
    "https://api.randaverify.com/verify-nin/share-code",
    headers={"Authorization": f"Bearer {token}"},
    json={"share_code": "AB12CD", "reason": "corporate"},
    timeout=30,
)

Response (200)

Same shape as the standard NIN response. The full record is returned, including the unmasked NIN (the share code is itself a consented disclosure by the holder).

Failure modes

Status	When	Recover by
400	Share code rejected by NIMC (expired, malformed, already-used)	Ask the holder to regenerate a new code in the NIMC app.
402	Org wallet empty	Top up.

Operational notes

• Share codes are single-use and time-limited by NIMC (typically valid for a short window after generation). Use them quickly.
• The returned nin is the holder’s real NIN — store it according to your data-protection policy.