> For the complete documentation index, see [llms.txt](https://docs.corppass.gov.sg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.corppass.gov.sg/technical-specifications/corppass-authorization-api-fapi-2.0/scopes/myinfo-business-scopes/entity-scopes.md).

# Entity Scopes

Myinfo Business entity scopes provide access to **business-related information** about the **entity the user is transacting on behalf of**.

These scopes are only available to [Myinfo Business applications](/products/myinfo-business.md).

The corresponding data is returned via the [Userinfo Endpoint](/technical-specifications/corppass-authorization-api-fapi-2.0/integration-guide/4.-userinfo-endpoint.md) under `entity_info`. Refer to [Entity Info](/technical-specifications/corppass-authorization-api-fapi-2.0/integration-guide/4.-userinfo-endpoint/entity-info.md) for more details.

## Basic Profile

<table><thead><tr><th width="214.703125" valign="top">Name</th><th width="259.81640625" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Company Type</td><td valign="top"><code>entity.basic_profile.company_type</code></td><td valign="top">Type of company.<br>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</td></tr><tr><td valign="top">Constitution</td><td valign="top"><code>entity.basic_profile.constitution</code></td><td valign="top">Constitution of Business or Public Accounting Firms.<br>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</td></tr><tr><td valign="top">Country of Incorporation</td><td valign="top"><code>entity.basic_profile.country_of_incorporation</code></td><td valign="top">Country of incorporation using ISO 3166-1 alpha-2 standard. Refer to <a href="https://www.iso.org/iso-3166-country-codes.html">ISO 3166</a> for possible values.</td></tr><tr><td valign="top">Expiry Date</td><td valign="top"><code>entity.basic_profile.expiry_date</code></td><td valign="top">Expiry date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Name</td><td valign="top"><code>entity.basic_profile.name</code></td><td valign="top">Entity's registered name.</td></tr><tr><td valign="top">Primary Activity</td><td valign="top"><code>entity.basic_profile.primary_activity</code></td><td valign="top">Primary activity using Singapore Standard Industrial Classification (SSIC) 2025 edition.<br>Refer to <a href="https://www.singstat.gov.sg/standard-classifications/national-classifications/singapore-standard-industrial-classification-ssic">Singapore Standard Industrial Classification (SSIC)</a> for possible values.</td></tr><tr><td valign="top">Registration Date</td><td valign="top"><code>entity.basic_profile.registration_date</code></td><td valign="top">Registration date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Registration Number</td><td valign="top"><code>entity.basic_profile.registration_number</code></td><td valign="top">Unique Entity Number (UEN).</td></tr><tr><td valign="top">Secondary Activity</td><td valign="top"><code>entity.basic_profile.secondary_activity</code></td><td valign="top">Secondary activity using Singapore Standard Industrial Classification (SSIC) 2025 edition.<br>Refer to <a href="https://www.singstat.gov.sg/standard-classifications/national-classifications/singapore-standard-industrial-classification-ssic">Singapore Standard Industrial Classification (SSIC)</a> for possible values.</td></tr><tr><td valign="top">Type</td><td valign="top"><code>entity.basic_profile.type</code></td><td valign="top"><p>Type of entity.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values. If this field is LC or FC, refer to <code>company_type</code>. If this field is BN or PF, refer to <code>constitution</code>.</p></td></tr><tr><td valign="top">UEN Status</td><td valign="top"><code>entity.basic_profile.uen_status</code></td><td valign="top"><p>UEN registration status.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr></tbody></table>

## Address

<table><thead><tr><th width="215.0390625" valign="top">Name</th><th width="259.66015625" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Address</td><td valign="top"><code>entity.address</code></td><td valign="top">Entity's latest registered address details.</td></tr></tbody></table>

## History

<table><thead><tr><th width="215.0390625" valign="top">Name</th><th width="259.90234375" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Previous Name</td><td valign="top"><code>entity.history.previous_names.previous_name</code></td><td valign="top">Previous name.</td></tr><tr><td valign="top">Previous Name Effective Date</td><td valign="top"><code>entity.history.previous_names.previous_name_effective_date</code></td><td valign="top">Previous name effective date in "YYYY-MM-DD" date.</td></tr><tr><td valign="top">Previous Registration Number</td><td valign="top"><code>entity.history.previous_registration_numbers.previous_registration_number</code></td><td valign="top">Previous registration number.</td></tr></tbody></table>

## Appointments

<table><thead><tr><th width="214.94921875" valign="top">Name</th><th width="260.203125" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Appointment Date</td><td valign="top"><code>entity.appointments.appointment_date</code></td><td valign="top">Position appointment date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Appointment Position</td><td valign="top"><code>entity.appointments.position</code></td><td valign="top"><p>Position of the appointment holder.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Appointment Position Category</td><td valign="top"><code>entity.appointments.category</code></td><td valign="top"><p>Position category of the appointment holder.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Designation</td><td valign="top"><code>entity.appointments.designation</code></td><td valign="top">Designation of the appointment holder.</td></tr><tr><td valign="top">Entity Appointment - Name</td><td valign="top"><code>entity.appointments.entity_appointment.name</code></td><td valign="top">Entity's registered name.</td></tr><tr><td valign="top">Entity Appointment - Registration Number</td><td valign="top"><code>entity.appointments.entity_appointment.registration_number</code></td><td valign="top">Unique Entity Number (UEN) / Foreign Business Registration Number (FBRN).</td></tr><tr><td valign="top">Entity Appointment - Type</td><td valign="top"><code>entity.appointments.entity_appointment.type</code></td><td valign="top"><p>Type of entity.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Individual Appointment - ID Number</td><td valign="top"><code>entity.appointments.individual_appointment.id_number</code></td><td valign="top"><p>ID number of person as lodged by the entity at registration.</p><p>Note: This ID is not verified by government.</p></td></tr><tr><td valign="top">Individual Appointment - ID Type</td><td valign="top"><code>entity.appointments.individual_appointment.id_type</code></td><td valign="top">Type of identification document. Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</td></tr><tr><td valign="top">Individual Appointment - Name</td><td valign="top"><code>entity.appointments.individual_appointment.name</code></td><td valign="top"><p>Name of person as lodged by entity at registration.</p><p>Note: This name is not verified by government.</p></td></tr><tr><td valign="top">Individual Appointment - Nationality</td><td valign="top"><code>entity.appointments.individual_appointment.nationality</code></td><td valign="top"><p>Nationality/Citizenship using SG-DRM data standard.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr></tbody></table>

## Stakeholders

<table><thead><tr><th width="214.61328125" valign="top">Name</th><th width="259.67578125" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Entity Shareholder - Name</td><td valign="top"><code>entity.shareholders.entity_shareholder.name</code></td><td valign="top">Entity's registered name.</td></tr><tr><td valign="top">Entity Shareholder - Registration Number</td><td valign="top"><code>entity.shareholders.entity_shareholder.registration_number</code></td><td valign="top">Unique Entity Number (UEN) / Foreign Business Registration Number (FBRN).</td></tr><tr><td valign="top">Entity Shareholder - Type</td><td valign="top"><code>entity.shareholders.entity_shareholder.type</code></td><td valign="top"><p>Type of entity.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Individual Shareholder - ID Number</td><td valign="top"><code>entity.shareholders.individual_shareholder.id_number</code></td><td valign="top"><p>ID number of person as lodged by the entity at registration.</p><p>Note: This ID is not verified by government.</p></td></tr><tr><td valign="top">Individual Shareholder - ID Type</td><td valign="top"><code>entity.shareholders.individual_shareholder.id_type</code></td><td valign="top"><p>Type of identification document.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Individual Shareholder - Name</td><td valign="top"><code>entity.shareholders.individual_shareholder.name</code></td><td valign="top"><p>Name of person as lodged by entity at registration.</p><p>Note: This name is not verified by government.</p></td></tr><tr><td valign="top">Individual Shareholder - Nationality</td><td valign="top"><code>entity.shareholders.individual_shareholder.nationality</code></td><td valign="top"><p>Nationality/Citizenship using SG-DRM data standard.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Shareholders - Allocation</td><td valign="top"><code>entity.shareholders.allocation</code></td><td valign="top">Number of shares allotted.</td></tr><tr><td valign="top">Shareholders - Category</td><td valign="top"><code>entity.shareholders.category</code></td><td valign="top"><p>Shareholder category.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Shareholders - Currency</td><td valign="top"><code>entity.shareholders.currency</code></td><td valign="top"><p>Indicates the currency that the shares are held in.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Shareholders - Share Type</td><td valign="top"><code>entity.shareholders.share_type</code></td><td valign="top"><p>Type of shares.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr></tbody></table>

## Capitals

<table><thead><tr><th width="214.50390625" valign="top">Name</th><th width="260.37109375" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Capitals - Currency</td><td valign="top"><code>entity.capitals.currency</code></td><td valign="top"><p>Currency.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Capitals - Issued Amount</td><td valign="top"><code>entity.capitals.issued_amount</code></td><td valign="top"><p>Issued capital monetary amount.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Capitals - Paid-up Amount</td><td valign="top"><code>entity.capitals.paid_up_amount</code></td><td valign="top"><p>Paid-up capital monetary amount.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Capitals - Share Allotted Number</td><td valign="top"><code>entity.capitals.share_allotted_number</code></td><td valign="top">Allotted number of capital shares, not to be confused with currency as monetary sense.</td></tr><tr><td valign="top">Capitals - Share Type</td><td valign="top"><code>entity.capitals.share_type</code></td><td valign="top"><p>Type of capital shares.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr></tbody></table>

## Financials

<table><thead><tr><th width="215.4921875" valign="top">Name</th><th width="260.23046875" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Audit status</td><td valign="top"><code>entity.financials.is_audited</code></td><td valign="top">Whether financial statements are audited.</td></tr><tr><td valign="top">Company Financial - Profit Loss After Tax</td><td valign="top"><code>entity.financials.company_financial.profit_loss_after_tax</code></td><td valign="top"><p>Monetary value for company profit (loss) after tax from continuing operations in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Company Financial - Profit Loss Before Tax</td><td valign="top"><code>entity.financials.company_financial.profit_loss_before_tax</code></td><td valign="top"><p>Monetary value for company profit (loss) before tax from continuing operations in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Company Financial - Revenue</td><td valign="top"><code>entity.financials.company_financial.revenue</code></td><td valign="top"><p>Monetary value for company revenue in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Currency</td><td valign="top"><code>entity.financials.currency</code></td><td valign="top"><p>Currency.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Financial Period End Date</td><td valign="top"><code>entity.financials.current_period_end_date</code></td><td valign="top">Current financial period end date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Financial Period Start Date</td><td valign="top"><code>entity.financials.current_period_start_date</code></td><td valign="top">Current financial period start date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Group Financial - Profit Loss After Tax</td><td valign="top"><code>entity.financials.group_financial.profit_loss_after_tax</code></td><td valign="top"><p>Monetary value for group profit (loss) after tax from continuing operations in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Group Financial - Profit Loss Before Tax</td><td valign="top"><code>entity.financials.group_financial.profit_loss_before_tax</code></td><td valign="top"><p>Monetary value for group profit (loss) before tax from continuing operations in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Group Financial - Revenue</td><td valign="top"><code>entity.financials.group_financial.revenue</code></td><td valign="top"><p>Monetary value for group revenue in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr><tr><td valign="top">Group Financial - Share Capital</td><td valign="top"><code>entity.financials.group_financial.share_capital</code></td><td valign="top"><p>Monetary value for group share capital in the fiscal period.</p><p>Refer to <code>currency</code> for the currency.</p></td></tr></tbody></table>

## Grants

<table><thead><tr><th width="215.23046875" valign="top">Name</th><th width="259.625" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Development Category</td><td valign="top"><code>entity.grants.development_category</code></td><td valign="top"><p>Development category.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Functional Area</td><td valign="top"><code>entity.grants.functional_area</code></td><td valign="top"><p>Functional area.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Grant Submitted Date</td><td valign="top"><code>entity.grants.submitted_on_date</code></td><td valign="top">Date that the grant was submitted in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Grants Approved Amount</td><td valign="top"><code>entity.grants.approved_amount</code></td><td valign="top">Monetary amount approved by the grant. Currency is in SGD (Singapore Dollar).</td></tr><tr><td valign="top">Grants Last Update Date</td><td valign="top"><code>entity.grants.last_update_date</code></td><td valign="top">Date that the grant was last updated in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Grants Status</td><td valign="top"><code>entity.grants.status</code></td><td valign="top"><p>Status.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Grants type</td><td valign="top"><code>entity.grants.type</code></td><td valign="top"><p>Type of grant.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr></tbody></table>

## Licences

<table><thead><tr><th width="214.56640625" valign="top">Name</th><th width="259.76171875" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Issuance Agency</td><td valign="top"><code>entity.licences.issuance_agency</code></td><td valign="top"><p>Licence issuance agency.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Licence Expiry Date</td><td valign="top"><code>entity.licences.expiry_date</code></td><td valign="top">Licence expiry date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Licence Issue Date</td><td valign="top"><code>entity.licences.issue_date</code></td><td valign="top">Licence issue date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Licence Name</td><td valign="top"><code>entity.licences.licence_name</code></td><td valign="top">Licence name.</td></tr><tr><td valign="top">Licence Number</td><td valign="top"><code>entity.licences.licence_number</code></td><td valign="top">Unique licence number assign by agencies.</td></tr></tbody></table>

## Builders

<table><thead><tr><th width="215.14453125" valign="top">Name</th><th width="259.6171875" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Builders Licence</td><td valign="top"><code>entity.builders.licence</code></td><td valign="top"><p>Type of builder licence.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Builders Licence Expiry Date</td><td valign="top"><code>entity.builders.licence_expiry_date</code></td><td valign="top">Builder licence expiry date in "YYYY-MM-DD" format.</td></tr></tbody></table>

## Contractors

<table><thead><tr><th width="215.09765625" valign="top">Name</th><th width="260.4921875" valign="top">Scope</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Contractors CRS Expiry Date</td><td valign="top"><code>entity.contractors.crs_expiry_date</code></td><td valign="top">Contractors Registration System (CRS) expiry date in "YYYY-MM-DD" format.</td></tr><tr><td valign="top">Contractors Workhead</td><td valign="top"><code>entity.contractors.workhead</code></td><td valign="top"><p>Type of contractor workhead.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr><tr><td valign="top">Contractors Workhead Financial Grade</td><td valign="top"><code>entity.contractors.workhead_financial_grade</code></td><td valign="top"><p>Contractor workhead financial grade.</p><p>Refer to the <a href="/pages/Rq9I3YrjT7zPo96BfGQQ">OpenAPI</a> specification for possible values.</p></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.corppass.gov.sg/technical-specifications/corppass-authorization-api-fapi-2.0/scopes/myinfo-business-scopes/entity-scopes.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.
