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.

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:

{
  "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.