Fleet Dashboard API — Network Health and Uptime

Monitor your entire charging network. Access uptime, utilisation, error history, diagnostics, and maintenance records for every charger.

The fleet dashboard API gives you a live and historical view of every charger across your network. Use it to build operational dashboards, set up alerting, investigate faults, and manage planned maintenance.

Fleet summary

GET /api/v1/cpo/fleet/summary

Returns aggregate totals across your entire fleet — charger counts, online status, and active session numbers.

curl "https://api.dynamo-csms.com/api/v1/cpo/fleet/summary" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "total_chargers": 124,
  "online": 119,
  "offline": 5,
  "charging": 43,
  "available": 76,
  "faulted": 3,
  "active_sessions": 43,
  "total_energy_today_kwh": 1842.6
}

total_chargers · number

Total chargers registered in your fleet.

online · number

Chargers with an active OCPP connection.

offline · number

Chargers that have lost connectivity.

charging · number

Chargers with an active session.

available · number

Chargers ready to accept a new session.

faulted · number

Chargers reporting a fault or error status.

active_sessions · number

Total number of sessions currently in progress.

total_energy_today_kwh · number

Energy delivered across the fleet since midnight UTC today.

---

Fleet uptime

GET /api/v1/cpo/fleet/uptime

Returns uptime percentages per charger for a given time period.

from · string · required

ISO 8601 start date/time.

to · string · required

ISO 8601 end date/time.

charge_point_id · string

Filter results to a specific charger.

site_id · string

Filter results to chargers at a specific site.

curl "https://api.dynamo-csms.com/api/v1/cpo/fleet/uptime?from=2024-06-01T00:00:00Z&to=2024-06-30T23:59:59Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "period": {
    "from": "2024-06-01T00:00:00Z",
    "to": "2024-06-30T23:59:59Z"
  },
  "chargers": [
    {
      "charge_point_id": "CP-001",
      "site_id": "site_01HZ4K8XVPQR3TY5N6M",
      "uptime_percent": 98.7,
      "downtime_minutes": 558
    },
    {
      "charge_point_id": "CP-002",
      "site_id": "site_01HZ4K8XVPQR3TY5N6M",
      "uptime_percent": 94.1,
      "downtime_minutes": 2541
    }
  ]
}

---

Fleet utilisation

GET /api/v1/cpo/fleet/utilisation

Returns utilisation percentages showing what proportion of online time each charger was actively delivering energy.

from · string · required

ISO 8601 start date/time.

to · string · required

ISO 8601 end date/time.

charge_point_id · string

Filter to a specific charger.

site_id · string

Filter to chargers at a specific site.

granularity · string · default: "day"

Time bucket for results. Accepted values: hour, day, week, month.

curl "https://api.dynamo-csms.com/api/v1/cpo/fleet/utilisation?from=2024-06-01T00:00:00Z&to=2024-06-30T23:59:59Z&granularity=week" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "period": {
    "from": "2024-06-01T00:00:00Z",
    "to": "2024-06-30T23:59:59Z"
  },
  "granularity": "week",
  "chargers": [
    {
      "charge_point_id": "CP-001",
      "buckets": [
        { "period_start": "2024-06-03T00:00:00Z", "utilisation_percent": 61.2 },
        { "period_start": "2024-06-10T00:00:00Z", "utilisation_percent": 74.5 }
      ]
    }
  ]
}

---

Fleet errors

GET /api/v1/cpo/fleet/errors

Returns error events across your fleet, ordered by most recent first.

from · string

ISO 8601 start date/time.

to · string

ISO 8601 end date/time.

charge_point_id · string

Filter to a specific charger.

error_code · string

Filter by OCPP error code (e.g. ConnectorLockFailure).

limit · number · default: "50"

Maximum number of events to return.

curl "https://api.dynamo-csms.com/api/v1/cpo/fleet/errors?from=2024-06-01T00:00:00Z&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "errors": [
    {
      "event_id": "evt_88XQPMN",
      "charge_point_id": "CP-007",
      "site_id": "site_01HZ4K8XVPQR3TY5N6M",
      "error_code": "GroundFailure",
      "info": "Ground fault detected on connector 1",
      "status": "Faulted",
      "timestamp": "2024-06-15T14:22:00Z",
      "resolved_at": null
    }
  ],
  "total": 1
}

---

List fleet chargers

GET /api/v1/cpo/fleet/chargers

Returns a detailed list of all chargers in your fleet with their current status.

status · string

Filter by charger status. Accepted values: online, offline, charging, available, faulted.

site_id · string

Filter to chargers at a specific site.

limit · number · default: "50"

Maximum number of chargers to return.

offset · number · default: "0"

Pagination offset.

curl "https://api.dynamo-csms.com/api/v1/cpo/fleet/chargers?status=faulted" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "chargers": [
    {
      "charge_point_id": "CP-007",
      "site_id": "site_01HZ4K8XVPQR3TY5N6M",
      "vendor": "ABB",
      "model": "Terra AC",
      "firmware_version": "3.4.1",
      "status": "Faulted",
      "last_seen": "2024-06-15T14:22:10Z",
      "connectors": [
        { "connector_id": 1, "type": "Type2", "status": "Faulted" }
      ]
    }
  ],
  "total": 1
}

---

Get charger diagnostics

GET /api/v1/cpo/chargers/{charge_point_id}/diagnostics

Returns a diagnostic summary for a single charger including recent error patterns and health indicators.

charge_point_id · string · required

The OCPP identity of the charger.

curl "https://api.dynamo-csms.com/api/v1/cpo/chargers/CP-001/diagnostics" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "charge_point_id": "CP-001",
  "firmware_version": "3.5.0",
  "uptime_30d_percent": 98.7,
  "utilisation_30d_percent": 62.1,
  "error_count_30d": 2,
  "last_error": {
    "error_code": "WeakSignal",
    "timestamp": "2024-05-28T08:14:00Z"
  },
  "last_heartbeat": "2024-06-15T16:00:00Z",
  "ocpp_version": "1.6",
  "connectors": [
    {
      "connector_id": 1,
      "status": "Available",
      "total_sessions": 312,
      "total_energy_kwh": 4820.4
    }
  ]
}

---

Charger connectivity timeline

GET /api/v1/cpo/chargers/{charge_point_id}/connectivity

Returns a timeline of connect and disconnect events for a charger.

charge_point_id · string · required

The OCPP identity of the charger.

from · string

ISO 8601 start date/time.

to · string

ISO 8601 end date/time.

curl "https://api.dynamo-csms.com/api/v1/cpo/chargers/CP-001/connectivity?from=2024-06-01T00:00:00Z&to=2024-06-15T23:59:59Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "charge_point_id": "CP-001",
  "events": [
    { "type": "disconnected", "timestamp": "2024-06-04T02:10:00Z" },
    { "type": "connected",    "timestamp": "2024-06-04T02:12:45Z" }
  ]
}

---

Charger error history

GET /api/v1/cpo/chargers/{charge_point_id}/error-history

Returns the full error history for a specific charger.

charge_point_id · string · required

The OCPP identity of the charger.

from · string

ISO 8601 start date/time.

to · string

ISO 8601 end date/time.

limit · number · default: "50"

Maximum number of error events to return.

curl "https://api.dynamo-csms.com/api/v1/cpo/chargers/CP-001/error-history?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

List maintenance events

GET /api/v1/cpo/chargers/{charge_point_id}/maintenance

Returns all maintenance events recorded for a charger.

charge_point_id · string · required

The OCPP identity of the charger.

from · string

ISO 8601 start date/time.

to · string

ISO 8601 end date/time.

curl "https://api.dynamo-csms.com/api/v1/cpo/chargers/CP-001/maintenance" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "charge_point_id": "CP-001",
  "events": [
    {
      "event_id": "mnt_7YBKQ",
      "type": "scheduled",
      "description": "Quarterly inspection and connector cleaning",
      "scheduled_at": "2024-06-20T09:00:00Z",
      "completed_at": null,
      "technician": "J. Smith",
      "notes": null
    }
  ]
}

---

Create a maintenance event

POST /api/v1/cpo/chargers/{charge_point_id}/maintenance

Log a planned or completed maintenance event against a charger.

charge_point_id · string · required

The OCPP identity of the charger.

type · string · required

Maintenance type. Accepted values: scheduled, reactive, inspection.

description · string · required

Description of the work to be carried out or completed.

scheduled_at · string

ISO 8601 date/time the maintenance is planned for.

completed_at · string

ISO 8601 date/time the maintenance was completed. Omit if not yet done.

technician · string

Name or identifier of the assigned technician.

notes · string

Additional notes or findings.

curl -X POST "https://api.dynamo-csms.com/api/v1/cpo/chargers/CP-001/maintenance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "scheduled",
    "description": "Quarterly inspection and connector cleaning",
    "scheduled_at": "2024-07-20T09:00:00Z",
    "technician": "J. Smith"
  }'

{
  "event_id": "mnt_7YBKQ",
  "charge_point_id": "CP-001",
  "type": "scheduled",
  "description": "Quarterly inspection and connector cleaning",
  "scheduled_at": "2024-07-20T09:00:00Z",
  "completed_at": null,
  "technician": "J. Smith",
  "notes": null,
  "created_at": "2024-06-15T16:30:00Z"
}