# Personal

{% hint style="info" %}
Download the [OpenAPI specification file](https://docs.developer.singpass.gov.sg/docs/technical-specifications/integration-guide/5.-requesting-for-userinfo#person-information-openapi-specification) for the full list of Myinfo person data scopes, field structures, value types, accepted formats, and maximum field lengths. This serves as the technical reference for developers integrating with the Myinfo API.
{% endhint %}

<table><thead><tr><th width="109.79296875">id</th><th width="101.328125">name</th><th width="299.17578125">description</th><th>Data Available</th><th>Source</th></tr></thead><tbody><tr><td>uinfin</td><td>NRIC/FIN</td><td>NRIC number or FIN of user. NRIC number is the unique identifier given to every Singapore Citizens (SC) and Permanent Residents (PR), while FIN is the unique identifier for Foreigners.</td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>partialuinfin</td><td>Partial NRIC/FIN</td><td>Last 3 numerical digits and checksum of the NRIC/FIN number, prefixed with '*****' (e.g. "*****567A" from the full NRIC number of "S1234567A").</td><td>SC,PR,FIN</td><td>-</td></tr><tr><td>name</td><td>Principal Name</td><td>Includes Surname if any.<br>Note that Principal Name does not represent the full name as printed on the NRIC/FIN card or Digital IC (Read <a href="https://partnersupport.singpass.gov.sg/hc/en-sg/articles/32683301388569-Does-Myinfo-Principal-Name-match-the-Full-Name-printed-on-the-NRIC-FIN-card-or-Digital-IC">here</a> for more info)</td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>aliasname</td><td>Alias Name</td><td>Refers to an alternate/additional name of the user that is legally recognised.</td><td>SC,PR</td><td>ICA</td></tr><tr><td>hanyupinyinname</td><td>Hanyu Pinyin Name</td><td>Refers to the officially romanised Chinese name of the user.</td><td>SC,PR</td><td>ICA</td></tr><tr><td>hanyupinyinaliasname</td><td>Hanyu Pinyin Alias Name</td><td>Refers to the legally-recognised alternate officially romanised Chinese name of the user.</td><td>SC,PR</td><td>ICA</td></tr><tr><td>marriedname</td><td>Married Name</td><td>Refers to the family name or surname adopted by the user upon marriage.</td><td>SC,PR</td><td>ICA</td></tr><tr><td>sex</td><td>Sex</td><td>Gender of the user. Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (SexCode) for list of possible values.</td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>race</td><td>Race</td><td>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (RaceCode) for list of possible values.</td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>secondaryrace</td><td>Secondary Race</td><td><p>Refers to secondary racial category of the Person, if any.</p><p>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (RaceCode) for list of possible values.</p></td><td>SC,PR</td><td>ICA</td></tr><tr><td>dialect</td><td>Dialect</td><td>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (DialectCode) for list of possible values.</td><td>SC,PR</td><td>ICA</td></tr><tr><td>dob</td><td>Date of Birth</td><td></td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>residentialstatus</td><td>Residential Status</td><td>Indicate if the user is a Citizen, PR or others. Blank value will be returned for FIN holder. Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (ResidentialCode) for list of possible values.</td><td>SC,PR</td><td>ICA</td></tr><tr><td>nationality</td><td>Nationality/Citizenship</td><td>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (NationalityCitizenshipCode) for list of possible values.</td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>birthcountry</td><td>Country/Place of Birth</td><td>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (CountryPlaceCode) for list of possible values.</td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>passportnumber</td><td>Passport Number</td><td></td><td>SC</td><td>ICA</td></tr><tr><td>passportexpirydate</td><td>Passport Expiry Date</td><td></td><td>SC</td><td>ICA</td></tr><tr><td>passtype</td><td>Pass Type</td><td><p>This refers to the pass type of a FIN holder.</p><p>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (PassTypeCode) for list of possible values.</p><p>Note that this only applies to a FIN holder with a valid pass issued by ICA/MOM.</p></td><td>FIN</td><td>ICA/MOM</td></tr><tr><td>passstatus</td><td>Pass Status</td><td><p>This refers to the pass status of a FIN holder.</p><p>Available values:</p><ul><li>Live</li><li>Approved. (Interim status in which the FIN holder has yet to receive the pass)</li></ul><p>Note that this only applies to a FIN holder with a valid pass issued by ICA/MOM.</p></td><td>FIN</td><td>ICA/MOM</td></tr><tr><td>passexpirydate</td><td>Pass Expiry Date</td><td><p>This refers to the pass expiry date of a FIN holder.</p><p>Note that this only applies to a FIN holder with a valid pass issued by ICA/MOM.</p></td><td>FIN</td><td>ICA/MOM</td></tr><tr><td>employmentsector</td><td>Employment Sector</td><td><p>This refers to the employment sector of a FIN holder.</p><p>Note that this only applies to a FIN holder with a valid pass issued by MOM.</p></td><td>FIN</td><td>MOM</td></tr><tr><td>mobileno</td><td>Mobile Number</td><td>Mobile number must be made editable at digital services even though data source is Singpass.</td><td>SC,PR,FIN</td><td>Singpass</td></tr><tr><td>email</td><td>Email Address</td><td>Email address must be made editable at digital services even though data source is Singpass.</td><td>SC,PR,FIN</td><td>Singpass</td></tr><tr><td>regadd</td><td>Registered Address</td><td><p>For SC/PR - Registered address is the address that is printed on the NRIC card.</p><p>For FIN - Registered address is applicable for foreigners under the following Pass Types:<br><strong>ICA-issued Passes</strong><br>- Long Term Visit Pass / Long Term Visit Pass +<br>- Student Pass<br>- Immigration Exemption Order<br><br><strong>MOM-issued Passes</strong><br>- S Pass<br>- Employment Pass<br>- Personalised Employment Pass<br>- EntrePass<br>- Dependent Pass</p></td><td>SC,PR,FIN</td><td>ICA/MOM</td></tr><tr><td>hdbtype</td><td>Type of HDB</td><td><p>Note that this is determined based on user's Registered Address (if it is a HDB flat). It therefore has no association with HDB ownership.</p><p>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing</a> (HDBTypeCode) for list of possible values.</p></td><td>SC,PR,FIN</td><td>HDB</td></tr><tr><td>housingtype</td><td>Type of Housing</td><td><p>Note that this is determined based on user's Registered Address (if it is not a HDB flat). It has no association with housing ownership.</p><p>Refer to <a href="https://public.cloud.myinfo.gov.sg/dpp/frontend/assets/api-lib/myinfo/downloads/myinfo-api-code-tables.xlsx">Code Listing </a>(HousingTypeCode) for list of possible values.</p></td><td>SC,PR,FIN</td><td>URA</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.developer.singpass.gov.sg/docs/data-catalog-myinfo/catalog/personal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.