.. AUTO-GENERATED FILE. DO NOT EDIT.

Validate employee exists by employee number
===========================================

Summary
-------

- **Source repository:** ``jef-systems/jef-one-backend``
- **Source SHA:** ``fc63b90deba131d1510b6789c172b240e305d07c``
- **Source run id:** ``26362659871``
- **Module:** ``One``
- **Lambda function:** ``jef-one-validate-employee-exists-by-employee-number``
- **HTTP method:** ``GET``
- **Invocation mode:** ``sync``
- **Package mode:** ``no-package``
- **API category:** ``One Complex No Package Sync GET APIs``
- **API path:** ``/jef-one-validate-employee-exists-by-employee-number``
- **Endpoint URL:** ``https://mfr670zvsh.execute-api.ap-southeast-1.amazonaws.com/prod/jef-one-validate-employee-exists-by-employee-number?employee\_number=12345``
- **Documentation scope:** ``lambda-complex-no-packages``

Sync Read Rule
--------------

This GET API is documented as a direct synchronous read path.

Description
-----------

GET endpoint that validates whether an employee exists in jef-one-employees by employee\_number using gsi\_3 index get-by-employee-number. It does not scan and only returns safe non-authentication fields.

Payload Example
---------------

.. code-block:: json

   {
     "employee_number": "12345"
   }

Payload Schema
--------------

.. code-block:: json

   {
     "root": {
       "type": "M",
       "required": true,
       "attributes": {
         "employee_number": {
           "type": "S",
           "required": true,
           "regex": "^[0-9]{5}$"
         }
       }
     }
   }

Response Schema
---------------

.. code-block:: json

   {
     "root": {
       "type": "M",
       "required": true,
       "attributes": {
         "is_accepted": {
           "type": "BOOL",
           "required": true
         },
         "is_found": {
           "type": "BOOL",
           "required": true
         },
         "employee_exists": {
           "type": "BOOL",
           "required": true
         },
         "employee_active": {
           "type": "BOOL",
           "required": true
         },
         "can_continue": {
           "type": "BOOL",
           "required": true
         },
         "message_type": {
           "type": "S",
           "required": true
         },
         "message": {
           "type": "S",
           "required": true
         },
         "next_action": {
           "type": "S",
           "required": true
         },
         "operation": {
           "type": "S",
           "required": true
         },
         "status_code": {
           "type": "N",
           "required": true
         },
         "employee_id": {
           "type": "S",
           "required": false
         },
         "entity_number": {
           "type": "S",
           "required": false
         },
         "employee_number": {
           "type": "S",
           "required": false
         },
         "is_active": {
           "type": "BOOL",
           "required": false
         },
         "failure_code": {
           "type": "S",
           "required": false
         },
         "failure_reason": {
           "type": "S",
           "required": false
         },
         "missing_fields": {
           "type": "L",
           "required": false
         }
       }
     }
   }

CMD curl
--------

.. code-block:: bat

   curl -X GET "https://mfr670zvsh.execute-api.ap-southeast-1.amazonaws.com/prod/jef-one-validate-employee-exists-by-employee-number?employee_number=12345"

PowerShell curl
---------------

.. code-block:: powershell

   curl.exe -X GET "https://mfr670zvsh.execute-api.ap-southeast-1.amazonaws.com/prod/jef-one-validate-employee-exists-by-employee-number?employee_number=12345"