Update NIN

POST

/core/account/updatenin

Update NIN

Updates the National Identity Number (NIN) of an existing client.

POST /core/account/updatenin

Request Body

Field Name	Type	Required	Description
nin	string	true	The National Identity Number to set (max 100 characters).
clientId	integer	true	Unique identifier of the client (1 or greater).

Response

Field Name	Type	Description
clientId	integer	Unique identifier of the client whose NIN was updated.
id	integer	Savings account id linked to the client, when one exists.
subLedgerActivated	boolean	Always false in this response.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: {{tpGatewayHostUrl}}/security/authenticate

Body Params application/json

Example

{
  "nin": "11111111111",
  "clientId": 101
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/core/account/updatenin' \
--header 'Content-Type: application/json' \
--data '{
  "nin": "11111111111",
  "clientId": 101
}'

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
  "id": 54,
  "clientId": 101,
  "subLedgerActivated": false
}

🟠400| Source | Error | When |

🟠401| Source | Error | When |

🟠403| Source | Error | When |

🔴500| Source | Error | When |

Modified at 2026-11-02 05:49:15

Upload Client Passport

Create Client

Update NIN

Update NIN#

Request Body#

Response#

Request

Request Code Samples

Responses

Update NIN

Request Body

Response