The Policy object

{
    "id": "pol_BAmcmCVnWzqSlC5BFWKtpgHsOAo22N9N",
    "object": "policy",
    "created": "2026-04-01T00:39:10.282Z",
    "description": null,
    "metadata": {},
    "mode": "enforcement",
    "name": "Example Policy",
    "rules": {
        "allowed_operators": ["example_operator"],
        "denied_operators": [],
        "geofences": [
            {
                "center": {
                    "latitude": 48.8698,
                    "longitude": 2.3319
                },
                "name": "Example Zone",
                "radius_meters": 1500
            }
        ],
        "max_price_per_kwh": 25,
        "time_windows": [
            {
                "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"],
                "end_time": "18:00",
                "start_time": "09:00"
            }
        ]
    },
    "status": "active"
}

{
    "id": "pol_BAmcmCVnWzqSlC5BFWKtpgHsOAo22N9N",
    "object": "policy",
    "created": "2026-04-01T00:39:10.282Z",
    "description": null,
    "metadata": {},
    "mode": "enforcement",
    "name": "Example Policy",
    "rules": {
        "allowed_operators": ["example_operator"],
        "denied_operators": [],
        "geofences": [
            {
                "center": {
                    "latitude": 48.8698,
                    "longitude": 2.3319
                },
                "name": "Example Zone",
                "radius_meters": 1500
            }
        ],
        "max_price_per_kwh": 25,
        "time_windows": [
            {
                "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"],
                "end_time": "18:00",
                "start_time": "09:00"
            }
        ]
    },
    "status": "active"
}

This object represents a policy in Charge. Use it to define rules that restrict charging behavior or generate charging suggestions.

Attributes

string

required

Unique identifier for the object.

string

required

The operational mode of the policy.Available options: enforcement, suggestion

string

required

A human-readable name for the policy.

object

required

Rules that define how the policy behaves.

Show properties

array of string

A list of charging station operator IDs that are permitted.

array of string

A list of charging station operator IDs that are explicitly forbidden.

array of object

A list of geographic areas where charging is permitted.

Show properties

object

No description available.

Show properties

number

No description available.

number

No description available.

string

A name for the geofenced area.

integer

The radius from the center point in meters.

integer | null

The maximum allowable price per kilowatt-hour in the account’s default currency, in the smallest currency unit.

array of object

Defines when charging is permitted.

Show properties

array of string

Days of the week this window applies to.Available options: monday, tuesday, wednesday, thursday, friday, saturday, sunday

string

The end of the time window in 24-hour format.

string

The start of the time window in 24-hour format.

string

required

Current status of the policy.Available options: active, inactive

More attributes

string

required

String representing the object’s type.

string

required

Time at which the policy was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string | null

An optional description of the policy’s purpose.

object

Set of key-value pairs that you can attach to an object.

Getting Started

API Behavior

API Reference

The Policy object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes