> ## Documentation Index
> Fetch the complete documentation index at: https://dynamo-csms.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Charging API — Configure Site Load Management

> Configure site power limits and load balancing strategies. View real-time allocation per charger, review history, and trigger manual rebalancing.

The smart charging API manages how available grid power is distributed across the chargers at each site. You set a maximum power ceiling and choose a strategy, and Dynamo automatically adjusts charge rates in real time to stay within that limit.

Three strategies are available:

* **equal** — available power is divided equally across all active chargers
* **priority** — chargers are ranked; higher-priority chargers receive more power
* **scheduled** — power allocation follows a time-based schedule you define

## Configure smart charging for a site

`PUT /api/v1/smart-charging/sites/{site_id}/config`

Creates or replaces the smart charging configuration for a site. The configuration takes effect immediately.

<ParamField path="site_id" type="string" required>
  The site to configure smart charging for.
</ParamField>

<ParamField body="max_power_kw" type="number" required>
  Maximum power budget for smart charging in kilowatts. Must not exceed the site's grid connection capacity.
</ParamField>

<ParamField body="strategy" type="string" required>
  Load balancing strategy. Accepted values: `equal`, `priority`, `scheduled`.
</ParamField>

<ParamField body="min_power_per_charger_kw" type="number" default="1.4">
  Minimum power floor per charger. No charger will be allocated below this value while charging.
</ParamField>

<ParamField body="priority_order" type="string[]">
  Ordered list of `charge_point_id` values from highest to lowest priority. Required when `strategy` is `priority`.
</ParamField>

```bash theme={null}
curl -X PUT "https://api.dynamo-csms.com/api/v1/smart-charging/sites/site_01HZ4K8XVPQR3TY5N6M/config" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_power_kw": 100,
    "strategy": "priority",
    "min_power_per_charger_kw": 3.7,
    "priority_order": ["CP-001", "CP-002", "CP-003"]
  }'
```

```json theme={null}
{
  "site_id": "site_01HZ4K8XVPQR3TY5N6M",
  "max_power_kw": 100,
  "strategy": "priority",
  "min_power_per_charger_kw": 3.7,
  "priority_order": ["CP-001", "CP-002", "CP-003"],
  "updated_at": "2024-06-15T10:00:00Z"
}
```

<ResponseField name="site_id" type="string">
  The site this configuration applies to.
</ResponseField>

<ResponseField name="max_power_kw" type="number">
  Configured power ceiling.
</ResponseField>

<ResponseField name="strategy" type="string">
  Active load balancing strategy.
</ResponseField>

<ResponseField name="min_power_per_charger_kw" type="number">
  Minimum power floor per active charger.
</ResponseField>

<ResponseField name="priority_order" type="string[]">
  Ordered charger IDs for the `priority` strategy.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of the last configuration change.
</ResponseField>

***

## Get smart charging config

`GET /api/v1/smart-charging/sites/{site_id}/config`

Returns the current smart charging configuration for a site.

<ParamField path="site_id" type="string" required>
  The site to retrieve configuration for.
</ParamField>

```bash theme={null}
curl "https://api.dynamo-csms.com/api/v1/smart-charging/sites/site_01HZ4K8XVPQR3TY5N6M/config" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "site_id": "site_01HZ4K8XVPQR3TY5N6M",
  "max_power_kw": 100,
  "strategy": "equal",
  "min_power_per_charger_kw": 3.7,
  "priority_order": [],
  "updated_at": "2024-06-10T08:45:00Z"
}
```

***

## Get current power allocation

`GET /api/v1/smart-charging/sites/{site_id}/allocation`

Returns the live power allocation for every active charger at the site. Use this to understand what each charger is currently being allowed to draw.

<ParamField path="site_id" type="string" required>
  The site to retrieve allocation for.
</ParamField>

```bash theme={null}
curl "https://api.dynamo-csms.com/api/v1/smart-charging/sites/site_01HZ4K8XVPQR3TY5N6M/allocation" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "site_id": "site_01HZ4K8XVPQR3TY5N6M",
  "strategy": "equal",
  "total_budget_kw": 100,
  "total_allocated_kw": 73.6,
  "timestamp": "2024-06-15T16:00:00Z",
  "chargers": [
    {
      "charge_point_id": "CP-001",
      "allocated_kw": 18.4,
      "actual_kw": 17.9,
      "status": "Charging"
    },
    {
      "charge_point_id": "CP-002",
      "allocated_kw": 18.4,
      "actual_kw": 18.4,
      "status": "Charging"
    },
    {
      "charge_point_id": "CP-003",
      "allocated_kw": 18.4,
      "actual_kw": 12.1,
      "status": "Charging"
    },
    {
      "charge_point_id": "CP-004",
      "allocated_kw": 18.4,
      "actual_kw": 15.2,
      "status": "Charging"
    }
  ]
}
```

<ResponseField name="total_budget_kw" type="number">
  Total power budget configured for the site.
</ResponseField>

<ResponseField name="total_allocated_kw" type="number">
  Sum of allocations across all active chargers.
</ResponseField>

<ResponseField name="chargers" type="object[]">
  <Expandable title="properties">
    <ResponseField name="charge_point_id" type="string">Charger identifier.</ResponseField>
    <ResponseField name="allocated_kw" type="number">Maximum power this charger is allowed to draw.</ResponseField>
    <ResponseField name="actual_kw" type="number">Power the charger is actually drawing at this moment.</ResponseField>
    <ResponseField name="status" type="string">Current charger status.</ResponseField>
  </Expandable>
</ResponseField>

***

## Get allocation history

`GET /api/v1/smart-charging/sites/{site_id}/allocation/history`

Returns a time series of past power allocation decisions for the site. Useful for auditing, reporting, and understanding how allocations have changed over time.

<ParamField path="site_id" type="string" required>
  The site to retrieve history for.
</ParamField>

<ParamField query="from" type="string" required>
  ISO 8601 start date/time.
</ParamField>

<ParamField query="to" type="string" required>
  ISO 8601 end date/time.
</ParamField>

<ParamField query="granularity" type="string" default="15min">
  Time bucket size for aggregated results. Accepted values: `1min`, `5min`, `15min`, `1hour`.
</ParamField>

```bash theme={null}
curl "https://api.dynamo-csms.com/api/v1/smart-charging/sites/site_01HZ4K8XVPQR3TY5N6M/allocation/history?from=2024-06-15T00:00:00Z&to=2024-06-15T23:59:59Z&granularity=1hour" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "site_id": "site_01HZ4K8XVPQR3TY5N6M",
  "granularity": "1hour",
  "buckets": [
    {
      "period_start": "2024-06-15T08:00:00Z",
      "total_allocated_kw": 68.2,
      "total_actual_kw": 65.8,
      "active_chargers": 4
    },
    {
      "period_start": "2024-06-15T09:00:00Z",
      "total_allocated_kw": 82.5,
      "total_actual_kw": 79.1,
      "active_chargers": 5
    }
  ]
}
```

***

## Trigger manual rebalance

`POST /api/v1/smart-charging/sites/{site_id}/rebalance`

Forces an immediate recalculation and reapplication of power limits across all active chargers at the site. Dynamo recalculates automatically whenever sessions start or stop, but you can use this endpoint to trigger an out-of-cycle rebalance — for example, after changing a site's max power or updating priority order.

<ParamField path="site_id" type="string" required>
  The site to rebalance.
</ParamField>

```bash theme={null}
curl -X POST "https://api.dynamo-csms.com/api/v1/smart-charging/sites/site_01HZ4K8XVPQR3TY5N6M/rebalance" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "site_id": "site_01HZ4K8XVPQR3TY5N6M",
  "rebalanced_at": "2024-06-15T16:05:00Z",
  "chargers_updated": 4,
  "new_allocation": [
    { "charge_point_id": "CP-001", "allocated_kw": 25.0 },
    { "charge_point_id": "CP-002", "allocated_kw": 25.0 },
    { "charge_point_id": "CP-003", "allocated_kw": 25.0 },
    { "charge_point_id": "CP-004", "allocated_kw": 25.0 }
  ]
}
```

<ResponseField name="rebalanced_at" type="string">
  ISO 8601 timestamp of when the rebalance was applied.
</ResponseField>

<ResponseField name="chargers_updated" type="number">
  Number of chargers whose limits were recalculated.
</ResponseField>

<ResponseField name="new_allocation" type="object[]">
  The updated allocation for each active charger.
</ResponseField>