# Get forms for a user

Retrieves all forms accessible to a user based on their company context.

Requires JWT token authentication in the Authorization header.

- If subtype=tasks, returns all task forms for the user
- Otherwise, returns monitoring forms based on user access permissions

Endpoint: GET /api/control/forms/getForms
Version: 2.0.0
Security: bearerAuth

## Query parameters:

  - `auth0Id` (string, required)
    User identifier
    Example: "user_123456789"

  - `companyId` (string, required)
    Company identifier
    Example: "comp_12345"

  - `type` (string)
    Form type filter
    Example: "inspection"

  - `subtype` (string)
    Form subtype (e.g., 'tasks' for task forms)
    Example: "tasks"

## Response 200 fields (application/json):

  - `status` (string)
    Example: "success"

  - `data` (array)

  - `data._id` (string)
    Form unique identifier
    Example: "form_abc123"

  - `data.name` (string)
    Form name
    Example: "Hydrobit Inspection"

  - `data.formKey` (string)
    Form key identifier
    Example: "inspection_v1"

  - `data.type` (string)
    Form type
    Example: "inspection"

  - `data.subtype` (string)
    Form subtype (e.g., monitoring, task)
    Example: "monitoring"

  - `data.companyId` (string)
    Company identifier
    Example: "comp_12345"

  - `data.status` (string)
    Form status (e.g., published)
    Example: "published"

  - `data.elements` (array)
    Form field elements

  - `data.category` (string)
    Form category name
    Example: "phytosanitary"

  - `data.categoryId` (string)
    Category identifier
    Example: "cat_001"

  - `data.taskId` (string,null)
    Associated task identifier

  - `data.isTemporal` (boolean)
    Whether the form is temporary

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 401 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"