Technicians
===========
Technicians are users assigned to manage and support charging stations.
When creating a charging station, you can optionally assign a technician
to handle maintenance and support tasks for that station.

Reading
-------
Technicians can be accessed via the `technicians` `GET` endpoint.
This endpoint will return a list of all active technicians available
in your company.

The list endpoint is using
`offset pagination <pagination.html#offset-based-pagination>`__.

.. code-block:: bash

    curl --location --request GET \
    'https://<slug>.beenergised.cloud/api/cpoapi/v1/technicians/' \
    '?limit=50&offset=0' \
    --header 'Authorization: <access_token>' \
    --header 'Content-Type: application/json'

Response
--------
The response will contain a list of technicians with their details:

.. code-block:: json

    {
      "data": [
        {
          "id": 42,
          "uuid": "550e8400-e29b-41d4-a716-446655440000",
          "name": "John Doe",
          "email": "john.doe@example.com"
        },
        {
          "id": 43,
          "uuid": "550e8400-e29b-41d4-a716-446655440001",
          "name": "Jane Smith",
          "email": "jane.smith@example.com"
        }
      ],
      "meta": {
        "pagination": {
          "total": 2,
          "limit": 50,
          "offset": 0,
          "lastPage": true
        }
      },
      "links": {
        "current": "https://<slug>.beenergised.cloud/api/v1/technicians"
      }
    }

Parameters
----------
- **limit** (integer, optional): Number of technicians to return per
  page. Default is 50.
- **offset** (integer, optional): Pagination offset. Default is 0.

Important Notes
---------------
- Only **active** technicians are returned in the list.
- Only technicians from your company are visible.
- Results are sorted alphabetically by first name, then last name.
- The returned technician `id` is what you need to assign a
  technician when creating a charging station.