Toggle menu

Register a Citizen (online)

The following details are taken from the documentation available on

Citizens can be registered with MyAccount by providing their Personal details, Address details and Login Credentials. This Web Service can also be used to re-register a Citizen account if the account was already created for the Citizen previously. The Citizen Accounts created by this web service will be registered with Assurance Level Zero. On creation of the account an auto generated email will be sent to the provided Email Address which will contain a randomly generated one time password along with provided username. Citizen can use these credentials received in email to login into the MyAccount Portal.

If the account with the provided details happen to exist already, then the account password will be reset and the new password with the existing username will be sent as e-mail to the existing account's email address. If a password is reset, the Level of Assurance remains the same.

New accounts cannot be created with existing usernames. Email Addresses can also be provided as username. If the provided details like First name, Last name, Gender and Date of Birth match exactly with a unique record of the NHSCR data, then a Permanent UCRN is returned in response otherwise a Temporary UCRN is generated and returned. Also if multiple matches are found in NHSCR data, Middle Name, Mother's Birth Surname and Place of Birth provided in request can be used to uniquely match a record.


  • Either of Citizen details or UCRN can be passed for this web service. If both are passed the UCRN takes the precedence
  • Either of AddressInput or UPRN can be passed for this web service. If both are passed the UPRN takes the precedence
  • UCRNType and UPRNType will be ignored even if the permissible values are provided and will only work for the genuine UCRN and UPRN respectively


requires a UCRN or citizen details  consisting of a Name (firstname, lastname and optional middlename), gender, dateofbirth and optionally placeofbirth and mothersbirthsurname and a UPRN or an Address containing adressline1 (optionally addressline2 and addressline3) town, postcode and Local Authority Code and a contact (emailaddress with optional mobile and landline) and a username optionally a brandname


Using citizen details and address

    "firstname": "Goss",
    "middlename": "isstill",
    "lastname": "Testing",
    "gender": "M",
    "dateofbirth": "1999-11-15T00:00:00",
    "placeofbirth": "Plymouth",
    "mothersbirthsurname": "Netserve",
    "mobile": "",
    "landline": "0844 8803637",
    "emailaddress": "",
    "addressline1": "24 Darklake View",
    "town": "Plymouth",
    "postcode": "PL6 7TL",
    "lacode": "9079",
    "username": "goss.demo"
  "jsonrpc": "2.0"

using UCRN and UPRN

    "ucrn": "2100000000000000193",
    "ucrntype": "P",
    "uprn": "135024740",
    "uprntype": "P",
    "mobile": "",
    "landline": "0844 8803637",
    "emailaddress": "",
    "username": "goss.demo"
  "jsonrpc": "2.0"

Response Body

  • ucrn
    • value- UCRN associated with the provided Citizen details in request
    • ucrnType
  • uprn
    • value
    • uprnType
  • NECCardNumber - Same NEC Card number as provided in Request
  • username - Unique Username as provided in Request
  • emailaddress - Same EmailAddress as provided in Request
  • LoA - Level of Assurance associated with the newly created Citizen Account.

 Response Codes

Response  CodeResultResponse Message
10021FalseNo organization exist with the given LA code
0014FalseInvalid Email. Please enter a valid email id. (eg:
5047TruePassword Reset for Citizen account
5048TrueCitizen new account created
5049FalseUsername Already Exist
0461FalseNo Address found with the given UPRN
5013FalseDate of birth cannot be a future date
5016FalsePlease provide UPRNType P:Permanent
0426FalseNo record found with the given UCRN
1001FalseNo record found
10003FalseA technical error has been faced. Kindly try again later.


Last modified on June 27, 2023

Share this page

Facebook icon Twitter icon email icon


print icon