@fill-easy/api 1.0.12 → 1.0.13

package/dist/openapi.d.ts

@@ -34,15 +34,27 @@ export interface paths {
          * Authentication
          * @description Initialize user authentication with iAM Smart eID service.
          *
+         *
          *     **Browser Flow:**
-         *     Returns a TempAuthToken (store for subsequent calls) and a URL to iAM Smart's QR page. User scans the QR code with their iAM Smart mobile app, then the browser redirects to your specified redirect URL.
+         *
+         *     Returns a TempAuthToken (store for subsequent calls) and a URL to iAM Smart's QR page.
+         *     User scans the QR code with their iAM Smart mobile app, then the browser redirects
+         *     to your specified redirect URL.
+         *
          *
          *     **Mobile App Flow:**
-         *     Returns a universal link to launch the iAM Smart authentication app. After authentication, iAM Smart returns an auth_code via GET request to your redirect URI. Your mobile app must handle this redirect URI and pass the auth_code to the token endpoint.
+         *
+         *     Returns a universal link to launch the iAM Smart authentication app.
+         *     After authentication, iAM Smart returns an auth_code via GET request to your redirect URI.
+         *     Your mobile app must handle this redirect URI and pass the auth_code to the token endpoint.
+         *
          *
          *     **Redirect URI Requirements:**
-         *     - Browser: Must be an HTTPS URL registered with iAM Smart - Mobile: Must be a universal link or custom scheme (e.g., `your-app://auth`)
+         *
+         *     - Browser: Must be an HTTPS URL registered with iAM Smart
+         *     - Mobile: Must be a universal link or custom scheme (e.g., `your-app://auth`)
          *       that your mobile app can handle
+         *
          */
         post: operations["iamSmartAuthentication"];
         delete?: never;
@@ -64,15 +76,27 @@ export interface paths {
          * Form Filling
          * @description Request form filling data from authenticated user.
          *
-         *     Pass the form details, source, and AuthToken (from Authentication endpoint) to initialize the form filling request.
          *
-         *     Returns a temporary token to be used with Poll Data endpoint to retrieve the requested form filling details.
+         *     Pass the form details, source, and AuthToken (from Authentication endpoint)
+         *     to initialize the form filling request.
+         *
+         *
+         *     Returns a temporary token to be used with Poll Data endpoint to retrieve
+         *     the requested form filling details.
+         *
          *
          *     **Note on Profile Fields:**
-         *     If you request overlapping fields in both `profileFields` and `formData.formFields`, the `profileFields` takes precedence. You must display a consent page per iAM Smart UI/UX requirements when using profile fields.
+         *
+         *     If you request overlapping fields in both `profileFields` and `formData.formFields`,
+         *     the `profileFields` takes precedence. You must display a consent page per iAM Smart
+         *     UI/UX requirements when using profile fields.
+         *
          *
          *     **Note on Form Fields:**
-         *     The `formFields` array specifies which detail fields to request from the user. All requested fields will be displayed to the user in their iAM Smart app for approval.
+         *
+         *     The `formFields` array specifies which detail fields to request from the user.
+         *     All requested fields will be displayed to the user in their iAM Smart app for approval.
+         *
          */
         post: operations["iamSmartFormFilling"];
         delete?: never;
@@ -94,12 +118,22 @@ export interface paths {
          * Signing
          * @description Request digital signature for a document hash using iAM Smart.
          *
-         *     Pass the document details (name and SHA-256 hash), source platform, and the authenticated user token to initialize the signing request.
          *
-         *     Returns a temporary token and HKIC check digits. Use the token with the Poll Data endpoint to retrieve the signature results after the user approves the signing request in their iAM Smart app.
+         *     Pass the document details (name and SHA-256 hash), source platform, and the
+         *     authenticated user token to initialize the signing request.
+         *
+         *
+         *     Returns a temporary token and HKIC check digits. Use the token with the Poll Data
+         *     endpoint to retrieve the signature results after the user approves the signing
+         *     request in their iAM Smart app.
+         *
          *
          *     **Hash Requirements:**
-         *     - Must be a SHA-256 hash of the document content - Must be exactly 64 hexadecimal characters - Use SHA256withRSA signature algorithm (default)
+         *
+         *     - Must be a SHA-256 hash of the document content
+         *     - Must be exactly 64 hexadecimal characters
+         *     - Use SHA256withRSA signature algorithm (default)
+         *
          */
         post: operations["iamSmartHashSigning"];
         delete?: never;
@@ -121,12 +155,22 @@ export interface paths {
          * PDF Signing
          * @description Request PDF document signing with embedded digital signature using iAM Smart.
          *
-         *     Pass the PDF document details (name and base64-encoded hash), service description, and the authenticated user token to initialize the PDF signing request.
          *
-         *     Returns a temporary token and HKIC check digits. Use the token with the Poll Data endpoint to retrieve the signed PDF after the user approves the signing request in their iAM Smart app.
+         *     Pass the PDF document details (name and base64-encoded hash), service description,
+         *     and the authenticated user token to initialize the PDF signing request.
+         *
+         *
+         *     Returns a temporary token and HKIC check digits. Use the token with the Poll Data
+         *     endpoint to retrieve the signed PDF after the user approves the signing request
+         *     in their iAM Smart app.
+         *
          *
          *     **File Hash Requirements:**
-         *     - Must be a base64-encoded hash of the PDF file - The signed PDF will be returned with the signature embedded - PDF signature will be visible in PDF readers that support digital signatures
+         *
+         *     - Must be a base64-encoded hash of the PDF file
+         *     - The signed PDF will be returned with the signature embedded
+         *     - PDF signature will be visible in PDF readers that support digital signatures
+         *
          */
         post: operations["iamSmartPdfSigning"];
         delete?: never;
@@ -148,12 +192,23 @@ export interface paths {
          * Re-authentication
          * @description Re-authenticate a previously authenticated user to verify their identity again.
          *
-         *     Pass the authenticated user token and source platform to initialize the re-authentication request. This is useful for high-security operations that require fresh user verification.
          *
-         *     Returns a temporary token. Use this token with the Poll Data endpoint to retrieve the re-authentication results after the user approves the request in their iAM Smart app.
+         *     Pass the authenticated user token and source platform to initialize the
+         *     re-authentication request. This is useful for high-security operations that
+         *     require fresh user verification.
+         *
+         *
+         *     Returns a temporary token. Use this token with the Poll Data endpoint to
+         *     retrieve the re-authentication results after the user approves the request
+         *     in their iAM Smart app.
+         *
          *
          *     **Use Cases:**
-         *     - Verify user identity before sensitive operations - Refresh user authentication for extended sessions - Comply with security policies requiring periodic re-verification
+         *
+         *     - Verify user identity before sensitive operations
+         *     - Refresh user authentication for extended sessions
+         *     - Comply with security policies requiring periodic re-verification
+         *
          */
         post: operations["iamSmartReauthentication"];
         delete?: never;
@@ -191,10 +246,20 @@ export interface paths {
         /**
          * Anonymous Form Filling
          * @description Request form filling data without requiring prior authentication.
-         *     This endpoint combines authentication and form filling in a single flow. Pass the scope, language, source, redirect URL, and form details to initialize the anonymous form filling request.
-         *     Returns a token and URL. The URL redirects users to iAM Smart where they can authenticate and approve the form filling request in one step.
+         *
+         *     This endpoint combines authentication and form filling in a single flow.
+         *     Pass the scope, language, source, redirect URL, and form details to initialize
+         *     the anonymous form filling request.
+         *
+         *     Returns a token and URL. The URL redirects users to iAM Smart where they can
+         *     authenticate and approve the form filling request in one step.
+         *
          *     **Note on Profile Fields:**
-         *     If you request overlapping fields in both `profileFields` and `formData.formFields`, the `profileFields` takes precedence. You must display a consent page per iAM Smart UI/UX requirements when using profile fields.
+         *
+         *     If you request overlapping fields in both `profileFields` and `formData.formFields`,
+         *     the `profileFields` takes precedence. You must display a consent page per iAM Smart
+         *     UI/UX requirements when using profile fields.
+         *
          */
         post: operations["iamSmartAnonFormFilling"];
         delete?: never;
@@ -215,10 +280,19 @@ export interface paths {
         /**
          * Anonymous Hash Signing
          * @description Request digital signature for a document hash without requiring prior authentication.
-         *     This endpoint combines authentication and signing in a single flow. Pass the scope, language, source, redirect URL, and document details to initialize the anonymous signing request.
-         *     Returns a token, URL, and HKIC check digits. The URL redirects users to iAM Smart where they can authenticate and approve the signing request in one step.
+         *
+         *     This endpoint combines authentication and signing in a single flow.
+         *     Pass the scope, language, source, redirect URL, and document details to initialize
+         *     the anonymous signing request.
+         *
+         *     Returns a token, URL, and HKIC check digits. The URL redirects users to iAM Smart
+         *     where they can authenticate and approve the signing request in one step.
+         *
          *     **Hash Requirements:**
-         *     - Must be a SHA-256 hash of the document content - Must be exactly 64 hexadecimal characters
+         *
+         *     - Must be a SHA-256 hash of the document content
+         *     - Must be exactly 64 hexadecimal characters
+         *
          */
         post: operations["iamSmartAnonHashSigning"];
         delete?: never;
@@ -239,9 +313,12 @@ export interface paths {
         /**
          * Anonymous PDF Signing
          * @description Request digital signature for a PDF document without requiring prior authentication. This endpoint enables anonymous PDF signing where users can sign documents using their iAM Smart identity without a separate authentication step.
+         *
          *     The response includes a URL to the iAM Smart QR code page and a temporary token. Users scan the QR code with their iAM Smart mobile app (for desktop) or are redirected to the iAM Smart app (for mobile). After signing, users are redirected to the specified redirect URL.
          *
+         *
          *     **Use the temporary token** with the polling endpoint to retrieve the signed document once the user completes the signing process.
+         *
          */
         post: operations["iamSmartAnonPdfSigning"];
         delete?: never;
@@ -267,7 +344,10 @@ export interface paths {
         put?: never;
         /**
          * iAM Smart Government Callback
-         * @description This endpoint is called by iAM Smart government servers to deliver the encrypted results of user authentication, form filling, or signing requests. The content is encrypted and must be decrypted using the CEK (Content Encryption Key).
+         * @description This endpoint is called by iAM Smart government servers to deliver
+         *     the encrypted results of user authentication, form filling, or signing requests.
+         *     The content is encrypted and must be decrypted using the CEK (Content Encryption Key).
+         *
          */
         post: operations["govCallback"];
         delete?: never;
@@ -291,7 +371,10 @@ export interface paths {
         };
         /**
          * Redirect
-         * @description iAM Smart redirects the user to this endpoint after completing the authentication or service request flow. It processes the authorization code or error from iAM Smart and again redirects to the client's specified redirect URL.
+         * @description iAM Smart redirects the user to this endpoint after completing the authentication
+         *     or service request flow. It processes the authorization code or error from
+         *     iAM Smart and again redirects to the client's specified redirect URL.
+         *
          */
         get: operations["iamSmartRedirect"];
         put?: never;
@@ -587,15 +670,29 @@ export interface paths {
         put?: never;
         /**
          * Request
-         * @description Initialize a verification session by passing your callback URLs and the document type.
+         * @description Initialize a verification session by passing your callback URLs and the
+         *     document type.
+         *
          *
          *     **Browser Flow:**
-         *     Returns a **launch URL** (open on a **mobile browser**) and a **JWT** **`token`** that you must keep for polling status. After the user completes or cancels the H5 flow, the browser is redirected to your provided callback URL.
+         *
+         *     Returns a **launch URL** (open on a **mobile browser**) and a **JWT**
+         *     **`token`** that you must keep for polling status.
+         *     After the user completes or cancels the H5 flow, the browser is
+         *     redirected to your provided callback URL.
+         *
          *
          *     **Mobile App Flow:**
-         *     Use the returned **`url`** to open an in-app web view or the system browser on the phone. Use the returned **`token`** later with `/ocr/poll` to check the final decision.
          *
-         *     **Note:** The redirect is **UX-only**; you still need to call `/ocr/poll` with the returned `token` to obtain the authoritative decision.
+         *     Use the returned **`url`** to open an in-app web view or the system
+         *     browser on the phone.
+         *     Use the returned **`token`** later with `/ocr/poll` to check the final
+         *     decision.
+         *
+         *
+         *     **Note:** The redirect is **UX-only**; you still need to call `/ocr/poll` with the
+         *     returned `token` to obtain the authoritative decision.
+         *
          */
         post: operations["request1"];
         delete?: never;
@@ -615,18 +712,24 @@ export interface paths {
         put?: never;
         /**
          * Poll
-         * @description Check the status of a verification using the **`token`** returned by `/ocr/request`.
+         * @description Check the status of a verification using the **`token`** returned by
+         *     `/ocr/request`.
+         *
          *
          *     - Returns **202 Accepted** while the verification is **in progress**.
          *
-         *     - Returns **200 OK** when the verification is **completed** (Success / Failure / Void\*).
+         *     - Returns **200 OK** when the verification is **completed** (Success /
+         *     Failure / Void\*).
          *
          *     - Always responds with a concise **`summary`** (no raw payloads needed).
          *
          *
-         *     Send **only the** **`token`**. It already encapsulates the session identifiers.
+         *     Send **only the** **`token`**. It already encapsulates the session
+         *     identifiers.
+         *
          *
          *     **Terminal states:** `Success`, `Failure`, or `Void\*`.
+         *
          */
         post: operations["ocrPoll"];
         delete?: never;
@@ -646,10 +749,29 @@ export interface paths {
         put?: never;
         /**
          * Request
-         * @description This endpoint initiates a request to retrieve company registry documents.
-         *     When you have the Company ID of the company  (retrieved from /cra/{countryCode}/search/companies endpoint), the system will automatically fetch the document. If documentType is "BRC", it will invoke the BRC script, otherwise the CRA script.
-         *     When you don't have the Company ID, provide the company name, document type, and optional document year. The system will create a manual request for an agent to process.
-         *     The endpoint returns a JWT token that should be used with the `/cra/poll` endpoint to retrieve the document when ready.
+         * @description This endpoint may retrieve the company JSON and document via two methods:
+         *
+         *     #### Automated retrieval using Company ID for supported countries
+         *
+         *     If the country supplied in `countryCode` is in the [AutomatedCountry](/models) Model,
+         *     and the supplied `companyId` is valid, the system will automatically fetch the document.
+         *
+         *     In order to ensure a valid `companyId`, please validate using `/cra/{countryCode}/search/companies`.
+         *
+         *     In this case, `/cra/poll` will resolve in around 5 minutes.
+         *
+         *     The `/cra/{countryCode}/search/companies` endpoint will not return a
+         *     companyId for certain countries (empty string). In that case please
+         *     refer to the information in the section below.
+         *
+         *     #### Manual request for unsupported countries or missing Company ID
+         *
+         *     In case of unsupported countries or missing `companyId`, Fill Easy will manually process the request.
+         *     Retrieving this information may take longer (up to several days).
+         *
+         *     In any case, the endpoint returns a JWT token that should be used with the
+         *     `/cra/poll` endpoint to retrieve the document when ready.
+         *
          */
         post: operations["craRequest"];
         delete?: never;
@@ -658,7 +780,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/cra/{countryCode}/search/documents": {
+    "/cra/poll": {
         parameters: {
             query?: never;
             header?: never;
@@ -668,14 +790,21 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Search Company Documents
-         * @description This endpoint searches for and returns documents filed by a company with the Companies Registry. Documents are grouped by category (e.g., Annual Return, Director/Secretary Changes, Charges Filed, etc.).
+         * Poll Report
+         * @description Poll this endpoint to check the status of a company registry report
+         *     request. Keep polling until you receive a successful response with the
+         *     message "CRA ready" and a presigned URL to download the document.
+         *
+         *
+         *     If the report is not ready yet, you will receive a 202 status code with
+         *     the message "Report is pending".
+         *
          *
-         *     You can optionally filter by document type and year to narrow down the results.
+         *     Once the report is ready, the endpoint will bill the service and return
+         *     a presigned URL valid for 1 hour to download the PDF document.
          *
-         *     Document categories include: Annual Return, Director / Secretary Changes, Charges Filed, Incorporation & Name Change, Liquidation & Deregistration, Registered Office / Address, Share Capital, and Other.
          */
-        post: operations["searchDocuments"];
+        post: operations["craPoll"];
         delete?: never;
         options?: never;
         head?: never;
@@ -693,9 +822,22 @@ export interface paths {
         put?: never;
         /**
          * Search Companies by Name
-         * @description This endpoint performs a left-partial search for companies in the Companies Registry by company name. It supports both English and Chinese company names and returns a list of matching companies.
+         * @description This endpoint performs a search for companies in the respective country's
+         *     Companies Registry by company name. It supports both English and Chinese
+         *     company names and returns a list of matching companies.
+         *
+         *     Certain countries are unable to return a companyId - in those cases the
+         *     idType in the response will be "Unavailable" and companyId will be an
+         *     empty string.
+         *
+         *     The search will automatically detect if the input is in Chinese
+         *     characters and adjust the search parameters accordingly.
+         *
+         *     The type of search is dependent on the country:
+         *     Substring search: KY
+         *     Tokenized search (e.g. searching "PLE" will not result in "APPLE"): AU, SG
+         *     Left partial search: HK,
          *
-         *     The search will automatically detect if the input is in Chinese characters and adjust the search parameters accordingly.
          */
         post: operations["searchCompanies"];
         delete?: never;
@@ -704,7 +846,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/cra/{countryCode}/search/company": {
+    "/cra/{countryCode}/search/documents": {
         parameters: {
             query?: never;
             header?: never;
@@ -714,19 +856,29 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Get Company Base Information
-         * @description This endpoint retrieves the base information for a specific company from the Companies Registry using its Company ID (obtained from `/cra/{countryCode}/search/companies` endpoint).
+         * Search Company Documents
+         * @description This endpoint searches for and returns documents filed by a company with
+         *     the Companies Registry. Documents are grouped by category (e.g., Annual
+         *     Return, Director/Secretary Changes, Charges Filed, etc.).
+         *
+         *
+         *     You can optionally filter by document type and year to narrow down the
+         *     results.
+         *
+         *
+         *     Document categories include: Annual Return, Director / Secretary
+         *     Changes, Charges Filed, Incorporation & Name Change, Liquidation &
+         *     Deregistration, Registered Office / Address, Share Capital, and Other.
          *
-         *     The information includes company names (English and Chinese), status, type, category, incorporation date, dissolution date (if applicable), and any remarks.
          */
-        post: operations["searchCompany"];
+        post: operations["searchDocuments"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/cra/poll": {
+    "/cra/{countryCode}/search/company": {
         parameters: {
             query?: never;
             header?: never;
@@ -736,14 +888,21 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Poll Report
-         * @description Poll this endpoint to check the status of a company registry report request. Keep polling until you receive a successful response with the message "CRA ready" and a presigned URL to download the document.
+         * Get Company Base Information
+         * @description This endpoint retrieves the base information for a specific company from
+         *     the Companies Registry using its Company ID.
          *
-         *     If the report is not ready yet, you will receive a 202 status code with the message "Report is pending".
+         *     For Hong Kong Companies, the information includes company name (English and Chinese), status,
+         *     type, category, incorporation date, dissolution date (if applicable),
+         *     and any remarks.
+         *
+         *     For other countries, the information includes company name, status, category, incorporation date,
+         *     and other available details such as entity type, registration address, and remarks where
+         *     applicable. The exact fields returned may vary depending on the data provided by each
+         *     country’s registry.
          *
-         *     Once the report is ready, the endpoint will bill the service and return a presigned URL valid for 1 hour to download the PDF document.
          */
-        post: operations["craPoll"];
+        post: operations["searchCompany"];
         delete?: never;
         options?: never;
         head?: never;
@@ -907,6 +1066,11 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        /**
+         * @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code for regions with fully automated support.
+         * @enum {string}
+         */
+        AutomatedCountry: "HK" | "AU" | "CN";
         Error: {
             /**
              * @description Error message
@@ -943,36 +1107,16 @@ export interface components {
          */
         IamSmartLanguage: "en-US" | "zh-HK" | "zh-CN";
         /**
-         * Format: uri
-         * @description Redirect URI after user authorization. Browser: https URL to your website. Mobile: Universal link (your-app://) or app scheme.
+         * @description Redirect URI after user authorization.
+         *
+         *     Browser: https URL to your website.
+         *
+         *     Mobile: Universal link (your-app://) or app scheme.
+         *
          * @example https://www.yourwebsite.com/callback
+         * @example com.filleasy.app
          */
         RedirectUri: string;
-        /** @example {
-         *       "lang": "en-US",
-         *       "redirect": "fill-easy://auth",
-         *       "source": "android"
-         *     } */
-        IamSmartAuthRequest: {
-            lang?: components["schemas"]["IamSmartLanguage"];
-            source: components["schemas"]["IamSmartSource"];
-            redirect: components["schemas"]["RedirectUri"];
-            scope?: components["schemas"]["IamSmartScope"];
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "url": "https://hk.gov.iamsmart.testapp://auth?clientID=7688ff3048ff49b2b64578cf40867d1d&responseType=code&source=App_Link&redirectURI=fill-easy%3A%2F%2Fauth&scope=eidapi_auth%20eidapi_formFilling%20eidapi_sign%20eidapi_fr&lang=en-US&state=0aZwsZfcCxCJgRY9AHG6c0un3UZotMDjNqSF&brokerPage=true"
-         *     } */
-        IamSmartAuthResponse: {
-            /** @description Store this token for subsequent API calls */
-            token: components["schemas"]["Token"];
-            /**
-             * Format: uri
-             * @description Browser: URL to iAM Smart QR page for scanning. Mobile: Universal link to launch iAM Smart app.
-             * @example https://hk.gov.iamsmart.testapp://auth?clientID=...
-             */
-            url: string;
-        };
         FormData: {
             /**
              * @description Form title displayed to user in iAM Smart app
@@ -1001,7 +1145,10 @@ export interface components {
             formFields?: ("idNo" | "enName" | "chName" | "gender" | "prefix" | "maritalStatus" | "homeTelNumber" | "officeTelNumber" | "mobileNumber" | "emailAddress" | "residentialAddress" | "postalAddress" | "educationLevel" | "addressDocInfo" | "addressDocFile")[];
         };
         /**
-         * @description Mandatorily obtain specific profile fields. Note: You must display a consent page per iAM Smart UI/UX requirements when using these fields. If fields overlap between `profileFields` and `formData.formFields`, `profileFields` takes precedence.
+         * @description Mandatorily obtain specific profile fields.
+         *     Note: You must display a consent page per iAM Smart UI/UX requirements when using these fields.
+         *     If fields overlap between `profileFields` and `formData.formFields`, `profileFields` takes precedence.
+         *
          * @example [
          *       "idNo",
          *       "enName",
@@ -1010,281 +1157,17 @@ export interface components {
          *     ]
          */
         ProfileFields: ("idNo" | "enName" | "chName" | "birthDate" | "gender")[];
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "source": "PC_Browser",
-         *       "profileFields": [
-         *         "idNo",
-         *         "enName",
-         *         "chName",
-         *         "gender"
-         *       ],
-         *       "formData": {
-         *         "formName": "Fill Easy Contact Form",
-         *         "formNum": "FE_001",
-         *         "formDesc": "Contact Fill Easy",
-         *         "formFields": [
-         *           "prefix",
-         *           "maritalStatus",
-         *           "mobileNumber",
-         *           "emailAddress",
-         *           "residentialAddress"
-         *         ]
-         *       }
-         *     } */
-        IamSmartFormFillingRequest: {
-            /** @description The authenticated user token from the Authentication workflow */
-            token: components["schemas"]["Token"];
-            source: components["schemas"]["IamSmartSource"];
-            profileFields?: components["schemas"]["ProfileFields"];
-            formData: components["schemas"]["FormData"];
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U"
-         *     } */
-        IamSmartFormFillingResponse: {
-            /** @description Use this token in Poll Data to retrieve form filling results */
-            token: components["schemas"]["Token"];
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "source": "PC_Browser",
-         *       "name": "Fill Easy Contact Form",
-         *       "hash": "af8b6f626242f214be360fa7d412e42dacb2f48bc11bb089019a912930019300",
-         *       "service": "Digital Signing of Application Form"
-         *     } */
-        IamSmartHashSignRequest: {
-            /** @description The authenticated user token from the Authentication workflow */
-            token: components["schemas"]["Token"];
-            source: components["schemas"]["IamSmartSource"];
-            /**
-             * @description Document title displayed to user
-             * @example Sample Credit Card Application Form
-             */
-            name: string;
-            /**
-             * @description SHA-256 hash of the document file's content (64 hex characters)
-             * @example af8b6f626242f214be360fa7d412e42dacb2f48bc11bb089019a912930019300
-             */
-            hash: string;
-            /**
-             * @description Service description to be displayed to user
-             * @example Digital Signing of Application Form
-             */
-            service?: string;
-            /**
-             * @description Organisation name
-             * @example Fill Easy Limited
-             */
-            organisation?: string;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "hkic": 1524
-         *     } */
-        IamSmartHashSignResponse: {
-            /** @description Use this token in Poll Data to retrieve signing results */
-            token: components["schemas"]["Token"];
-            /**
-             * @description HKIC check digits for verification
-             * @example 1524
-             */
-            hkic: number;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "source": "PC_Browser",
-         *       "name": "Landsurvey Purchase Form",
-         *       "fileHash": "R3fJTKFPwkRw019fLk+L19y91DVgI9hy/G7u6+YiECk=",
-         *       "service": "Digital PDF Signing Powered by Fill Easy"
-         *     } */
-        IamSmartPdfSignRequest: {
-            /** @description The authenticated user token from the Authentication workflow */
-            token: components["schemas"]["Token"];
-            source: components["schemas"]["IamSmartSource"];
-            /**
-             * @description Document title displayed to user
-             * @example Landsurvey Purchase Form
-             */
-            name: string;
-            /**
-             * Format: byte
-             * @description Base64-encoded hash of the PDF file
-             * @example R3fJTKFPwkRw019fLk+L19y91DVgI9hy/G7u6+YiECk=
-             */
-            fileHash: string;
-            /**
-             * @description Service description to be displayed to user
-             * @example Digital PDF Signing Powered by Fill Easy
-             */
-            service: string;
-            /** @description Hash of HKIC for verification (optional) */
-            hkicHash?: string;
-            /** @description Department name (optional) */
-            department?: string;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "hkic": 4303
-         *     } */
-        IamSmartPdfSignResponse: {
-            /** @description Use this token in Poll Data to retrieve PDF signing results */
-            token: components["schemas"]["Token"];
-            /**
-             * @description HKIC check digits for verification
-             * @example 4303
-             */
-            hkic: number;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "source": "PC_Browser"
-         *     } */
-        IamSmartReauthRequest: {
-            /** @description The authenticated user token to re-validate */
-            token: components["schemas"]["Token"];
-            source: components["schemas"]["IamSmartSource"];
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U"
-         *     } */
-        IamSmartReauthResponse: {
-            /** @description Use this token in Poll Data to check re-authentication status */
-            token: components["schemas"]["Token"];
-        };
-        /** @example {
-         *       "lang": "en-US",
-         *       "source": "android",
-         *       "redirect": "fill-easy://formfilling",
-         *       "profileFields": [
-         *         "idNo",
-         *         "enName"
-         *       ],
-         *       "formData": {
-         *         "formName": "Anonymous Form",
-         *         "formNum": "AF_001",
-         *         "formDesc": "Anonymous form filling request",
-         *         "formFields": [
-         *           "mobileNumber",
-         *           "emailAddress"
-         *         ]
-         *       }
-         *     } */
-        IamSmartAnonFormFillingRequest: {
-            lang?: components["schemas"]["IamSmartLanguage"];
-            source: components["schemas"]["IamSmartSource"];
-            redirect: components["schemas"]["RedirectUri"];
-            scope?: components["schemas"]["IamSmartScope"];
-            profileFields?: components["schemas"]["ProfileFields"];
-            formData?: components["schemas"]["FormData"];
-            /**
-             * @description Android activity class (Android only)
-             * @example com.filleasy.app.MainActivity
-             */
-            activityClass?: string;
-            /** @description Additional activity parameters (Android only) */
-            activityParams?: string;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "url": "https://apigw-isit.staging-eid.gov.hk/..."
-         *     } */
-        IamSmartAnonFormFillingResponse: {
-            token: components["schemas"]["Token"];
-            /**
-             * Format: uri
-             * @description URL to redirect user for anonymous form filling
-             */
-            url: string;
-        };
-        /** @example {
-         *       "lang": "en-US",
-         *       "source": "android",
-         *       "redirect": "fill-easy://signing",
-         *       "name": "Document to Sign",
-         *       "fileHash": "af8b6f626242f214be360fa7d412e42dacb2f48bc11bb089019a912930019300",
-         *       "hkicHash": "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
-         *       "service": "Anonymous Digital Signing"
-         *     } */
-        IamSmartAnonHashSignRequest: {
-            lang?: components["schemas"]["IamSmartLanguage"];
-            source: components["schemas"]["IamSmartSource"];
-            redirect: components["schemas"]["RedirectUri"];
-            scope?: components["schemas"]["IamSmartScope"];
-            /** @description Document title */
-            name: string;
-            /** @description SHA-256 hash of document (64 hex characters) */
-            fileHash: string;
-            /** @description Hash of HKIC for verification */
-            hkicHash?: string;
-            /** @description Service description */
-            service: string;
-            /** @description Organisation name */
-            organisation?: string;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "url": "https://apigw-isit.staging-eid.gov.hk/...",
-         *       "hkic": 1524
-         *     } */
-        IamSmartAnonHashSignResponse: {
-            token: components["schemas"]["Token"];
-            /**
-             * Format: uri
-             * @description URL to redirect user for anonymous signing
-             */
-            url: string;
-            /** @description HKIC check digits */
-            hkic: number;
-        };
-        /** @example {
-         *       "lang": "en-US",
-         *       "source": "PC_Browser",
-         *       "redirect": "https://yourapp.com/callback",
-         *       "name": "PDF Document",
-         *       "fileHash": "R3fJTKFPwkRw019fLk+L19y91DVgI9hy/G7u6+YiECk=",
-         *       "hkicHash": "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
-         *       "service": "Anonymous PDF Signing"
-         *     } */
-        IamSmartAnonPdfSignRequest: {
-            lang?: components["schemas"]["IamSmartLanguage"];
-            source: components["schemas"]["IamSmartSource"];
-            redirect: components["schemas"]["RedirectUri"];
-            scope?: components["schemas"]["IamSmartScope"];
-            /** @description PDF document title */
-            name: string;
-            /**
-             * Format: byte
-             * @description Base64-encoded hash of PDF
-             */
-            fileHash: string;
-            /** @description Hash of HKIC for verification */
-            hkicHash?: string;
-            /** @description Service description */
-            service: string;
-        };
-        /** @example {
-         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
-         *       "url": "https://apigw-isit.staging-eid.gov.hk/...",
-         *       "hkic": 4303
-         *     } */
-        IamSmartAnonPdfSignResponse: {
-            token: components["schemas"]["Token"];
-            /** Format: uri */
-            url: string;
-            hkic: number;
-        };
         GlobalSESFields: {
-            /** @description Email addresses for notifications */
+            /** @description Email participants of the CorpVerify e-mail thread */
             emailList?: string[];
-            /** @description External reference ID */
+            /** @description Client's reference ID (for invoicing and tracking) */
             externalRefId?: string;
             /** @description Additional request details */
             requestDetails?: string;
             /** @description Request express processing */
             express?: boolean;
         };
-        CompanySearchResult: {
+        Company: {
             /** @description Company ID (use this value in other endpoints) */
             companyId: string;
             /** @description Type of company identifier (e.g., "BRN" for Hong Kong, "ACN" for Australia) */
@@ -1310,13 +1193,6 @@ export interface components {
             /** @description Registered address of the company */
             address?: string;
         };
-        poll: {
-            /**
-             * @description The JWT token obtained from the previous request.
-             * @example {{token}}
-             */
-            token: string;
-        };
     };
     responses: {
         /** @description Unauthorized - Token is missing, invalid, or expired */
@@ -1354,13 +1230,7 @@ export interface components {
          */
         IamSmartServicePath: "auth" | "formfilling" | "formfilling-anonymous" | "signing" | "signing-anonymous" | "pdf-signing" | "pdf-signing-anonymous" | "reauth" | "ccic";
     };
-    requestBodies: {
-        poll: {
-            content: {
-                "application/json": components["schemas"]["poll"];
-            };
-        };
-    };
+    requestBodies: never;
     headers: never;
     pathItems: never;
 }
@@ -1393,17 +1263,35 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartAuthRequest"];
+                "application/json": {
+                    lang?: components["schemas"]["IamSmartLanguage"];
+                    source: components["schemas"]["IamSmartSource"];
+                    redirect: components["schemas"]["RedirectUri"];
+                    scope?: components["schemas"]["IamSmartScope"];
+                };
             };
         };
         responses: {
-            /** @description Authentication request successfully initialized. Store the token for subsequent API calls. */
+            /** @description Authentication request successfully initialized.
+             *     Store the token for subsequent API calls.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartAuthResponse"];
+                    "application/json": {
+                        /** @description Store this token for subsequent API calls */
+                        token: components["schemas"]["Token"];
+                        /**
+                         * Format: uri
+                         * @description Browser: URL to iAM Smart QR page for scanning.
+                         *     Mobile: Universal link to launch iAM Smart app.
+                         *
+                         * @example https://hk.gov.iamsmart.testapp://auth?clientID=...
+                         */
+                        url: string;
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1420,17 +1308,28 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartFormFillingRequest"];
+                "application/json": {
+                    /** @description The authenticated user token from the Authentication workflow */
+                    token: components["schemas"]["Token"];
+                    source: components["schemas"]["IamSmartSource"];
+                    profileFields?: components["schemas"]["ProfileFields"];
+                    formData: components["schemas"]["FormData"];
+                };
             };
         };
         responses: {
-            /** @description Form filling request successfully initialized. Poll with the returned token to retrieve form data when ready. */
+            /** @description Form filling request successfully initialized.
+             *     Poll with the returned token to retrieve form data when ready.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartFormFillingResponse"];
+                    "application/json": {
+                        /** @description Use this token in Poll Data to retrieve form filling results */
+                        token: components["schemas"]["Token"];
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1447,17 +1346,51 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartHashSignRequest"];
+                "application/json": {
+                    /** @description The authenticated user token from the Authentication workflow */
+                    token: components["schemas"]["Token"];
+                    source: components["schemas"]["IamSmartSource"];
+                    /**
+                     * @description Document title displayed to user
+                     * @example Sample Credit Card Application Form
+                     */
+                    name: string;
+                    /**
+                     * @description SHA-256 hash of the document file's content (64 hex characters)
+                     * @example af8b6f626242f214be360fa7d412e42dacb2f48bc11bb089019a912930019300
+                     */
+                    hash: string;
+                    /**
+                     * @description Service description to be displayed to user
+                     * @example Digital Signing of Application Form
+                     */
+                    service?: string;
+                    /**
+                     * @description Organisation name
+                     * @example Fill Easy Limited
+                     */
+                    organisation?: string;
+                };
             };
         };
         responses: {
-            /** @description Signing request successfully initialized. Poll with the returned token to get signature results. */
+            /** @description Signing request successfully initialized.
+             *     Poll with the returned token to get signature results.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartHashSignResponse"];
+                    "application/json": {
+                        /** @description Use this token in Poll Data to retrieve signing results */
+                        token: components["schemas"]["Token"];
+                        /**
+                         * @description HKIC check digits for verification
+                         * @example 1524
+                         */
+                        hkic: number;
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1474,17 +1407,51 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartPdfSignRequest"];
+                "application/json": {
+                    /** @description The authenticated user token from the Authentication workflow */
+                    token: components["schemas"]["Token"];
+                    source: components["schemas"]["IamSmartSource"];
+                    /**
+                     * @description Document title displayed to user
+                     * @example Landsurvey Purchase Form
+                     */
+                    name: string;
+                    /**
+                     * Format: byte
+                     * @description Base64-encoded hash of the PDF file
+                     * @example R3fJTKFPwkRw019fLk+L19y91DVgI9hy/G7u6+YiECk=
+                     */
+                    fileHash: string;
+                    /**
+                     * @description Service description to be displayed to user
+                     * @example Digital PDF Signing Powered by Fill Easy
+                     */
+                    service: string;
+                    /** @description Hash of HKIC for verification (optional) */
+                    hkicHash?: string;
+                    /** @description Department name (optional) */
+                    department?: string;
+                };
             };
         };
         responses: {
-            /** @description PDF signing request successfully initialized. Poll with the returned token to retrieve signed PDF when ready. */
+            /** @description PDF signing request successfully initialized.
+             *     Poll with the returned token to retrieve signed PDF when ready.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartPdfSignResponse"];
+                    "application/json": {
+                        /** @description Use this token in Poll Data to retrieve PDF signing results */
+                        token: components["schemas"]["Token"];
+                        /**
+                         * @description HKIC check digits for verification
+                         * @example 4303
+                         */
+                        hkic: number;
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1501,17 +1468,26 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartReauthRequest"];
+                "application/json": {
+                    /** @description The authenticated user token to re-validate */
+                    token: components["schemas"]["Token"];
+                    source: components["schemas"]["IamSmartSource"];
+                };
             };
         };
         responses: {
-            /** @description Re-authentication request successfully initialized. Poll with the returned token to get re-authentication results. */
+            /** @description Re-authentication request successfully initialized.
+             *     Poll with the returned token to get re-authentication results.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartReauthResponse"];
+                    "application/json": {
+                        /** @description Use this token in Poll Data to check re-authentication status */
+                        token: components["schemas"]["Token"];
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1546,17 +1522,40 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartAnonFormFillingRequest"];
+                "application/json": {
+                    lang?: components["schemas"]["IamSmartLanguage"];
+                    source: components["schemas"]["IamSmartSource"];
+                    redirect: components["schemas"]["RedirectUri"];
+                    scope?: components["schemas"]["IamSmartScope"];
+                    profileFields?: components["schemas"]["ProfileFields"];
+                    formData?: components["schemas"]["FormData"];
+                    /**
+                     * @description Android activity class (required if source is android)
+                     * @example com.filleasy.app.MainActivity
+                     */
+                    activityClass?: string | null;
+                    /** @description Additional activity parameters (optional if source is android) */
+                    activityParams?: string | null;
+                };
             };
         };
         responses: {
-            /** @description Anonymous form filling request successfully initialized. Redirect user to the URL, then poll with the token to retrieve form data. */
+            /** @description Anonymous form filling request successfully initialized.
+             *     Redirect user to the URL, then poll with the token to retrieve form data.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartAnonFormFillingResponse"];
+                    "application/json": {
+                        token: components["schemas"]["Token"];
+                        /**
+                         * Format: uri
+                         * @description URL to redirect user for anonymous form filling
+                         */
+                        url: string;
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1573,17 +1572,43 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartAnonHashSignRequest"];
+                "application/json": {
+                    lang?: components["schemas"]["IamSmartLanguage"];
+                    source: components["schemas"]["IamSmartSource"];
+                    redirect: components["schemas"]["RedirectUri"];
+                    scope?: components["schemas"]["IamSmartScope"];
+                    /** @description Document title */
+                    name: string;
+                    /** @description SHA-256 hash of document (64 hex characters) */
+                    fileHash: string;
+                    /** @description Hash of HKIC for verification */
+                    hkicHash?: string;
+                    /** @description Service description */
+                    service: string;
+                    /** @description Organisation name */
+                    organisation?: string;
+                };
             };
         };
         responses: {
-            /** @description Anonymous signing request successfully initialized. Redirect user to the URL, then poll with the token to retrieve signature. */
+            /** @description Anonymous signing request successfully initialized.
+             *     Redirect user to the URL, then poll with the token to retrieve signature.
+             *      */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartAnonHashSignResponse"];
+                    "application/json": {
+                        token: components["schemas"]["Token"];
+                        /**
+                         * Format: uri
+                         * @description URL to redirect user for anonymous signing
+                         */
+                        url: string;
+                        /** @description HKIC check digits */
+                        hkic: number;
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1600,7 +1625,23 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IamSmartAnonPdfSignRequest"];
+                "application/json": {
+                    lang?: components["schemas"]["IamSmartLanguage"];
+                    source: components["schemas"]["IamSmartSource"];
+                    redirect: components["schemas"]["RedirectUri"];
+                    scope?: components["schemas"]["IamSmartScope"];
+                    /** @description PDF document title */
+                    name: string;
+                    /**
+                     * Format: byte
+                     * @description Base64-encoded hash of PDF
+                     */
+                    fileHash: string;
+                    /** @description Hash of HKIC for verification */
+                    hkicHash?: string;
+                    /** @description Service description */
+                    service: string;
+                };
             };
         };
         responses: {
@@ -1610,7 +1651,12 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["IamSmartAnonPdfSignResponse"];
+                    "application/json": {
+                        token: components["schemas"]["Token"];
+                        /** Format: uri */
+                        url: string;
+                        hkic: number;
+                    };
                 };
             };
             400: components["responses"]["BadRequest"];
@@ -1790,11 +1836,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /**
-                     * Format: uri
-                     * @description Callback URL to redirect after verification
-                     */
-                    redirect: string;
+                    redirect: components["schemas"]["RedirectUri"];
                     /**
                      * @description QR code type
                      * @enum {string}
@@ -1853,8 +1895,7 @@ export interface operations {
                 "application/json": {
                     /** @description attributes to be requested from user */
                     attributes: string[];
-                    /** @description raw full callback URL */
-                    redirect: string;
+                    redirect: components["schemas"]["RedirectUri"];
                 };
             };
         };
@@ -1896,8 +1937,7 @@ export interface operations {
                 "application/json": {
                     /** @description attributes to be requested from user */
                     attributes?: string[];
-                    /** @description raw full callback URL */
-                    redirect?: string;
+                    redirect?: components["schemas"]["RedirectUri"];
                 };
             };
         };
@@ -2104,7 +2144,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    redirect: string;
+                    redirect: components["schemas"]["RedirectUri"];
                 };
             };
         };
@@ -2165,18 +2205,25 @@ export interface operations {
                 "application/json": {
                     /**
                      * Format: uri
-                     * @description Where to redirect the user **after success**. Must be publicly reachable over **https**.
+                     * @description Where to redirect the user **after success**.
+                     *     Must be publicly reachable over **https**.
+                     *
                      * @example https://example.com/ocr/complete
                      */
                     completeCallbackUrl: string;
                     /**
                      * Format: uri
-                     * @description Where to redirect the user if they **cancel/exit**. Must be publicly reachable over **https**.
+                     * @description Where to redirect the user if they **cancel/exit**.
+                     *     Must be publicly reachable over **https**.
+                     *
                      * @example https://example.com/ocr/interrupt
                      */
                     interruptCallbackUrl: string;
                     /**
-                     * @description The identity document type to verify. `00000001003` (Passport), `08520000002` (HKID New), `08520000001` (HKID Old). Use the exact code for your target document.
+                     * @description The identity document type to verify.
+                     *     `00000001003` (Passport), `08520000002` (HKID New), `08520000001` (HKID Old).
+                     *     Use the exact code for your target document.
+                     *
                      * @example 08520000002
                      * @enum {string}
                      */
@@ -2194,11 +2241,15 @@ export interface operations {
                     "application/json": {
                         /**
                          * Format: uri
-                         * @description Launch URL to open on a mobile browser or in an in-app web view. This URL contains the configuration for the H5 verification flow.
+                         * @description Launch URL to open on a mobile browser or in an in-app web view.
+                         *     This URL contains the configuration for the H5 verification flow.
+                         *
                          * @example https://<cdn>/page/realid-fe/index.html?clientcfg=eyJ...
                          */
                         url: string;
-                        /** @description JWT token carrying bizId and transactionId. Store this token to poll for verification results using `/ocr/poll`. */
+                        /** @description JWT token carrying bizId and transactionId.
+                         *     Store this token to poll for verification results using `/ocr/poll`.
+                         *      */
                         token: components["schemas"]["Token"];
                     };
                 };
@@ -2430,11 +2481,11 @@ export interface operations {
             content: {
                 "application/json": {
                     /** @description Name of the company */
-                    companyName: string;
+                    companyName?: string;
                     /** @description Company ID (e.g., BRN for Hong Kong, ACN for Australia) */
                     companyId?: string;
-                    /** @description ISO 3166-1 alpha-2 country code. Supported values are "HK" (Hong Kong) and "AU" (Australia) */
-                    countryCode: string;
+                    /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code. */
+                    countryCode: components["schemas"]["AutomatedCountry"] | string;
                     /** @description Type of document */
                     documentType: string;
                     /** @description Year of the document */
@@ -2476,78 +2527,231 @@ export interface operations {
             };
         };
     };
-    searchDocuments: {
+    craPoll: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description ISO 3166-1 alpha-2 country code. Supported values are "HK" (Hong Kong) and "AU" (Australia) */
-                countryCode: "hk" | "au";
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description Company ID (e.g., BRN for Hong Kong, ACN for Australia) */
-                    companyId: string;
-                    /**
-                     * @description Optional filter by document type
-                     * @enum {string}
-                     */
-                    documentType?: "financialStatement" | "annualReturn";
-                    /** @description Optional filter by year */
-                    documentYear?: number;
+                    token: components["schemas"]["Token"];
                 };
             };
         };
         responses: {
-            /** @description Successfully retrieved documents grouped by category */
+            /** @description Report is ready */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        /**
-                         * @description Status of the operation
-                         * @enum {string}
-                         */
-                        message: "success" | "search error";
-                        /** @description JSON object where keys are document categories and values are arrays of documents */
-                        result?: {
-                            [key: string]: {
-                                /** @description Accounting year (for annual returns) */
-                                arAcYear?: string;
-                                /** @description English name of the document */
-                                docEnNameDisplay?: string;
-                                /** @description Number of pages */
-                                docPages?: string;
-                                /**
-                                 * Format: date
-                                 * @description Filing date (YYYY-MM-DD format)
-                                 */
-                                filingDateForDisplay?: string;
-                                /** @description Unique document identifier */
-                                documentId?: string;
-                                /** @description Company ID */
-                                companyId?: string;
-                                /** @description Whether the document has linked files */
-                                hasLinked?: boolean;
-                            }[];
+                        /** @description Metadata about the report generation */
+                        reportMetadata: {
+                            /**
+                             * Format: date
+                             * @description Date when the report was generated
+                             */
+                            reportDate?: string;
+                            /**
+                             * @description [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-2) of the report source
+                             * @example CN
+                             */
+                            countryCode: string;
+                            /**
+                             * @description Status of the report generation
+                             * @example completed
+                             * @enum {string}
+                             */
+                            status: "completed" | "processing";
                         };
+                        /** @description Array of original documents with presigned URLs (valid for 7 days). Only populated for non-unified document types. */
+                        originalDocuments?: {
+                            /**
+                             * Format: uri
+                             * @description Presigned URL to download the document
+                             */
+                            link?: string | null;
+                            /** @description Name of the document file */
+                            fileName?: string | null;
+                        }[] | null;
+                        /** @description Company identification details with bilingual support */
+                        companyIdentification?: {
+                            companyName?: {
+                                english?: string | null;
+                                local?: string;
+                            };
+                            /** @description Company registration number */
+                            companyId?: string | null;
+                            /** @description Type of company number (e.g., USCC, BRN) */
+                            idType?: string | null;
+                            previousCompanyNames?: {
+                                english?: string | null;
+                                local?: string;
+                            }[];
+                        } | null;
+                        /** @description Company registration details with bilingual support */
+                        registrationDetails?: {
+                            /** Format: date */
+                            incorporationDate?: string | null;
+                            status?: {
+                                english?: string;
+                                local?: string;
+                            } | null;
+                            companyType?: {
+                                english?: string;
+                                local?: string;
+                            } | null;
+                            jurisdiction?: string;
+                        } | null;
+                        /** @description Company location information with bilingual support */
+                        location?: {
+                            registeredAddress?: {
+                                english?: string | null;
+                                local?: string;
+                            } | null;
+                            principalPlaceOfBusiness?: {
+                                english?: string | null;
+                                local?: string | null;
+                            } | null;
+                        } | null;
+                        /** @description Company management structure with bilingual support */
+                        management?: {
+                            directors?: {
+                                name?: {
+                                    english?: string | null;
+                                    local?: string;
+                                };
+                                role?: {
+                                    english?: string;
+                                    local?: string;
+                                };
+                                identityDocuments?: string[];
+                                address?: string | null;
+                                /** Format: date */
+                                appointmentDate?: string | null;
+                            }[];
+                            companySecretary?: {
+                                name?: {
+                                    english?: string | null;
+                                    local?: string;
+                                };
+                                address?: string | null;
+                            } | null;
+                            legalRepresentative?: {
+                                name?: {
+                                    english?: string | null;
+                                    local?: string;
+                                };
+                                isCorporate?: boolean;
+                            } | null;
+                        } | null;
+                        /** @description Company ownership/shareholder information with bilingual support */
+                        ownership?: {
+                            shareholders?: {
+                                name?: {
+                                    english?: string | null;
+                                    local?: string;
+                                };
+                                isCorporate?: boolean;
+                                address?: string | null;
+                                sharesHeld?: {
+                                    class?: {
+                                        english?: string | null;
+                                        local?: string;
+                                    };
+                                    count?: number;
+                                }[];
+                                totalShares?: number;
+                                ownershipPercentage?: number;
+                            }[];
+                            ultimateHoldingCompany?: {
+                                name?: {
+                                    english?: string | null;
+                                    local?: string;
+                                };
+                                jurisdiction?: string | null;
+                            } | null;
+                        } | null;
+                        /** @description Share capital information with bilingual support */
+                        shareCapital?: {
+                            issuedCapital?: {
+                                amount?: number;
+                                currency?: string;
+                            } | null;
+                            paidUpCapital?: {
+                                amount?: number;
+                                currency?: string;
+                            } | null;
+                            authorizedCapital?: {
+                                amount?: number;
+                                currency?: string;
+                            } | null;
+                        } | null;
+                        /** @description Company operations details with bilingual support */
+                        operations?: {
+                            businessActivity?: {
+                                english?: string;
+                                local?: string;
+                            } | null;
+                            financialYearEnd?: string | null;
+                        } | null;
+                        /** @description Company compliance and filing history with bilingual support */
+                        compliance?: {
+                            registeredAgent?: {
+                                name?: string;
+                                address?: string;
+                            } | null;
+                            filingHistory?: {
+                                totalDocuments?: number;
+                                summary?: {
+                                    category?: {
+                                        english?: string;
+                                        local?: string;
+                                    };
+                                    count?: number;
+                                }[];
+                            } | null;
+                            riskInformation?: Record<string, never> | null;
+                            intellectualProperty?: Record<string, never> | null;
+                        } | null;
                     };
                 };
             };
-            /** @description Bad Request - Invalid input parameters */
-            400: {
+            /** @description Report is still being processed */
+            202: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": {
+                        /** @description Metadata about the report generation */
+                        reportMetadata: {
+                            /**
+                             * Format: date
+                             * @description Date when the report was generated
+                             */
+                            reportDate?: string;
+                            /**
+                             * @description [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-2) of the report source
+                             * @example CN
+                             */
+                            countryCode: string;
+                            /**
+                             * @description Status of the report generation
+                             * @example completed
+                             * @enum {string}
+                             */
+                            status: "completed" | "processing";
+                        };
+                    };
+                };
             };
-            /** @description No documents found */
-            404: {
+            /** @description Invalid token */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2567,8 +2771,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description ISO 3166-1 alpha-2 country code. Supported values are "HK" (Hong Kong) and "AU" (Australia) */
-                countryCode: "hk" | "cn" | "au";
+                /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code in lowercase. */
+                countryCode: "hk" | "cn" | "au" | "sg" | "ky";
             };
             cookie?: never;
         };
@@ -2591,7 +2795,7 @@ export interface operations {
                         /** @description Response message */
                         message: string;
                         /** @description Array of companies matching the search criteria */
-                        result?: components["schemas"]["CompanySearchResult"][];
+                        result?: components["schemas"]["Company"][];
                     };
                 };
             };
@@ -2618,13 +2822,13 @@ export interface operations {
             };
         };
     };
-    searchCompany: {
+    searchDocuments: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description ISO 3166-1 alpha-2 country code. Supported values are "HK" (Hong Kong) and "AU" (Australia) */
-                countryCode: "hk" | "au";
+                /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code. */
+                countryCode: "hk" | "au" | "sg";
             };
             cookie?: never;
         };
@@ -2633,11 +2837,18 @@ export interface operations {
                 "application/json": {
                     /** @description Company ID (e.g., BRN for Hong Kong, ACN for Australia) */
                     companyId: string;
+                    /**
+                     * @description Optional filter by document type
+                     * @enum {string}
+                     */
+                    documentType?: "financialStatement" | "annualReturn";
+                    /** @description Optional filter by year */
+                    documentYear?: number;
                 };
             };
         };
         responses: {
-            /** @description Successfully retrieved company information */
+            /** @description Successfully retrieved documents as a flat array */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2649,40 +2860,31 @@ export interface operations {
                          * @enum {string}
                          */
                         message: "success" | "search error";
-                        /** @description Company base information object */
+                        /** @description array of documents filed by the company. */
                         result?: {
-                            /** @description Business Registration Number / Company ID */
-                            brn?: string;
-                            /** @description English company name */
-                            enName?: string;
-                            /** @description Chinese company name */
-                            cnName?: string;
                             /**
-                             * @description Current status of the company
+                             * @description Document category (e.g., Annual Return, Director / Secretary Changes)
                              * @enum {string}
                              */
-                            status?: "Live" | "Dissolved";
-                            /** @description Type of company */
-                            type?: string;
-                            /** @description Category of entity */
-                            category?: string;
-                            /**
-                             * Format: date
-                             * @description Date of dissolution (YYYY-MM-DD format, empty if not dissolved)
-                             */
-                            dissolutionDate?: string;
+                            category: "Annual Return" | "Director / Secretary Changes" | "Charges Filed" | "Incorporation & Name Change" | "Liquidation & Deregistration" | "Registered Office / Address" | "Share Capital" | "Other";
+                            /** @description Accounting year (for annual returns) */
+                            documentYear?: string;
+                            /** @description English name of the document */
+                            documentName: string;
+                            /** @description Number of pages */
+                            pages?: string;
                             /**
                              * Format: date
-                             * @description Date of incorporation/registration (YYYY-MM-DD format)
+                             * @description Filing date (YYYY-MM-DD format)
                              */
-                            incorporationDate?: string;
-                            /** @description English remarks */
-                            enRemarks?: string;
-                            /** @description Simplified Chinese remarks */
-                            scRemarks?: string;
-                            /** @description Traditional Chinese remarks */
-                            tcRemarks?: string;
-                        };
+                            filingDate?: string;
+                            /** @description Unique document identifier */
+                            documentId: string;
+                            /** @description Company ID */
+                            companyId: string;
+                            /** @description Whether the document has linked files */
+                            hasLinked?: boolean;
+                        }[];
                     };
                 };
             };
@@ -2693,7 +2895,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Company not found */
+            /** @description No documents found */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -2709,53 +2911,83 @@ export interface operations {
             };
         };
     };
-    craPoll: {
+    searchCompany: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code. */
+                countryCode: "hk" | "au" | "sg";
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description JWT token from /cra/request endpoint */
-                    token: string;
+                    /** @description Company ID (e.g., BRN for Hong Kong, ACN for Australia) */
+                    companyId: string;
                 };
             };
         };
         responses: {
-            /** @description Report is ready */
+            /** @description Successfully retrieved company information */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        /** @example CRA ready */
-                        message?: string;
                         /**
-                         * Format: uri
-                         * @description Presigned URL to download the PDF (valid for 1 hour). Points to the requested company registry document in PDF format.
+                         * @description Status of the operation
+                         * @enum {string}
                          */
-                        data?: string;
+                        message: "success" | "search error";
+                        /** @description Company object (Other Countries) or Company base information object (HK) */
+                        result?: components["schemas"]["Company"][] | {
+                            /** @description Business Registration Number / Company ID */
+                            brn?: string;
+                            /** @description English company name */
+                            enName?: string;
+                            /** @description Chinese company name */
+                            cnName?: string;
+                            /**
+                             * @description Current status of the company
+                             * @enum {string}
+                             */
+                            status?: "Live" | "Dissolved";
+                            /** @description Type of company */
+                            type?: string;
+                            /** @description Category of entity */
+                            category?: string;
+                            /**
+                             * Format: date
+                             * @description Date of dissolution (YYYY-MM-DD format, empty if not dissolved)
+                             */
+                            dissolutionDate?: string;
+                            /**
+                             * Format: date
+                             * @description Date of incorporation/registration (YYYY-MM-DD format)
+                             */
+                            incorporationDate?: string;
+                            /** @description English remarks */
+                            enRemarks?: string;
+                            /** @description Simplified Chinese remarks */
+                            scRemarks?: string;
+                            /** @description Traditional Chinese remarks */
+                            tcRemarks?: string;
+                        };
                     };
                 };
             };
-            /** @description Report is still being processed */
-            202: {
+            /** @description Bad Request - Invalid input parameters */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": {
-                        /** @example Report is pending */
-                        message?: string;
-                    };
-                };
+                content?: never;
             };
-            /** @description Invalid token */
-            400: {
+            /** @description Company not found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2780,14 +3012,13 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
+                    redirect: components["schemas"]["RedirectUri"];
                     /**
-                     * Format: uri
-                     * @description After the user has authorized the login, UAE Pass will redirect the user to the provided URI. For **Browser**: use https://www.yourwebsite.com/ For **Mobile app**: use your-app://
-                     * @example https://google.com
-                     */
-                    redirect: string;
-                    /**
-                     * @description List of values, separated by spaces, that represent the scope of the authorization that the application wants to obtain. It queries the scopes required for accessing the resources or services in question. Available scopes: sub, fullnameAR, gender, mobile, lastnameEN, fullnameEN, uuid, lastnameAR, idn, nationalityEN, firstnameEN, userType, nationalityAR, firstnameAR, email. (To be shared by UAEPASS Team if its value is other than specified in sample above)
+                     * @description List of values, separated by spaces, that represent the scope of the authorization that the application wants to obtain.
+                     *     It queries the scopes required for accessing the resources or services in question.
+                     *     Available scopes: sub, fullnameAR, gender, mobile, lastnameEN, fullnameEN, uuid, lastnameAR, idn, nationalityEN, firstnameEN, userType, nationalityAR, firstnameAR, email.
+                     *     (To be shared by UAEPASS Team if its value is other than specified in sample above)
+                     *
                      * @example sub fullnameEN email mobile
                      */
                     scope?: string;
@@ -2835,7 +3066,13 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody: components["requestBodies"]["poll"];
+        requestBody: {
+            content: {
+                "application/json": {
+                    token: components["schemas"]["Token"];
+                };
+            };
+        };
         responses: {
             /** @description Success */
             200: {
@@ -2845,29 +3082,7 @@ export interface operations {
                 content: {
                     "application/json": {
                         message?: string;
-                        token?: string;
-                    };
-                };
-            };
-            /** @description Result pending */
-            202: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        message?: string;
-                    };
-                };
-            };
-            /** @description 401 Authentication / 401 FormFilling / 401 Signing / 401 PDF Signing / 401 Re-authentication reject / 401 Re-authentication failed verification / 401 FormFilling Anonymous / 401 Signing Anonymous reject / 401 Signing Anonymous failed verification / 401 PDF Signing Anonymous reject / 401 PDF Signing Anonymous failed verification */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        message?: string;
+                        token?: components["schemas"]["Token"];
                     };
                 };
             };
@@ -2901,11 +3116,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /**
-                     * Format: uri
-                     * @description URL to redirect after logout
-                     */
-                    redirect: string;
+                    redirect: components["schemas"]["RedirectUri"];
                 };
             };
         };