OCPP 1.6 Commands — Start, Stop, and Control Sessions

The OCPP 1.6 API lets you send standard OCPP 1.6 commands to any charge point connected to Dynamo CSMS. Commands are executed in real time over the existing OCPP WebSocket connection. All endpoints require an organization API key with the write:charge_points scope unless noted otherwise. Base URL: https://api.dynamo-csms.com

Send generic command

POST /api/v1/ocpp16/send_command Sends any arbitrary OCPP 1.6 command to a charge point. Use the specific command endpoints below when available — this endpoint is intended for commands not covered by dedicated routes.

charge_point_id

string

required

The target charge point’s unique identifier.

command

string

required

OCPP 1.6 action name (e.g. "GetConfiguration", "ChangeConfiguration", "GetLocalListVersion").

payload

object

required

Command-specific payload as defined in the OCPP 1.6 specification.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/send_command \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "command": "GetConfiguration",
    "payload": {
      "key": ["HeartbeatInterval", "MeterValueSampleInterval"]
    }
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "command": "GetConfiguration",
  "status": "Accepted",
  "response": {
    "configurationKey": [
      {
        "key": "HeartbeatInterval",
        "readonly": false,
        "value": "30"
      },
      {
        "key": "MeterValueSampleInterval",
        "readonly": false,
        "value": "30"
      }
    ],
    "unknownKey": []
  },
  "sent_at": "2024-03-10T15:00:00Z",
  "response_time_ms": 218
}

status

string

OCPP response status from the charge point. Typically Accepted, Rejected, or NotImplemented.

response

object

Raw OCPP response payload from the charge point.

response_time_ms

integer

Round-trip latency in milliseconds between the API and the charge point.

Remote start transaction

POST /api/v1/ocpp16/remote_start_transaction Instructs the charge point to start a charging session on the specified connector, as if an RFID card with the given id_tag was presented at the hardware.

charge_point_id

string

required

Target charge point identifier.

id_tag

string

required

The RFID identifier or user token to authorize the session (max 20 characters).

connector_id

integer

Connector number to start on. If omitted, the charge point selects an available connector.

charging_profile

object

Optional OCPP ChargingProfile to apply to the session. Controls power limits and schedules.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/remote_start_transaction \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "id_tag": "RFID-USER-4A2F",
    "connector_id": 1
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "connector_id": 1,
  "id_tag": "RFID-USER-4A2F",
  "status": "Accepted",
  "sent_at": "2024-03-10T15:05:00Z"
}

A status of Accepted means the charge point acknowledged the command. The session will start once the charge point sends a StartTransaction message — subscribe to webhooks or poll active_transactions to confirm.

Remote stop transaction

POST /api/v1/ocpp16/remote_stop_transaction Remotely stops an active charging session.

charge_point_id

string

required

Target charge point identifier.

transaction_id

integer

required

The OCPP transaction ID of the session to stop. Retrieve this from the active transactions endpoint.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/remote_stop_transaction \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "transaction_id": 10042
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "transaction_id": 10042,
  "status": "Accepted",
  "sent_at": "2024-03-10T16:00:00Z"
}

Change availability

POST /api/v1/ocpp16/change_availability Changes the availability of a connector or the entire charge point.

charge_point_id

string

required

Target charge point identifier.

connector_id

integer

required

Connector to change. Use 0 to apply the change to all connectors on the charge point.

type

string

required

New availability state. Must be one of:

"Operative" — connector accepts new sessions
"Inoperative" — connector rejects new sessions (e.g. for maintenance)

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/change_availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "connector_id": 2,
    "type": "Inoperative"
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "connector_id": 2,
  "type": "Inoperative",
  "status": "Accepted",
  "sent_at": "2024-03-10T15:10:00Z"
}

If the connector is currently in a session, the charge point may return "Scheduled" — the change will take effect when the session ends.

Set charging profile

POST /api/v1/ocpp16/set_charging_profile Applies an OCPP charging profile to a connector to limit or schedule charging power.

charge_point_id

string

required

Target charge point identifier.

connector_id

integer

required

Target connector. Use 0 to set a charge-point-wide profile.

charging_profile

object

required

OCPP 1.6 ChargingProfile object.

Show charging_profile fields

charging_profile.chargingProfileId

integer

required

Unique profile ID (chosen by you).

charging_profile.stackLevel

integer

required

Profile priority. Higher values take precedence.

charging_profile.chargingProfilePurpose

string

required

One of: ChargePointMaxProfile, TxDefaultProfile, TxProfile.

charging_profile.chargingProfileKind

string

required

One of: Absolute, Recurring, Relative.

charging_profile.chargingSchedule

object

required

Schedule definition including chargingRateUnit ("A" or "W") and chargingSchedulePeriod array.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/set_charging_profile \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "connector_id": 1,
    "charging_profile": {
      "chargingProfileId": 101,
      "stackLevel": 0,
      "chargingProfilePurpose": "TxDefaultProfile",
      "chargingProfileKind": "Absolute",
      "chargingSchedule": {
        "chargingRateUnit": "W",
        "chargingSchedulePeriod": [
          {"startPeriod": 0, "limit": 7400},
          {"startPeriod": 3600, "limit": 11000}
        ]
      }
    }
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "connector_id": 1,
  "charging_profile_id": 101,
  "status": "Accepted",
  "sent_at": "2024-03-10T15:15:00Z"
}

Clear charging profile

POST /api/v1/ocpp16/clear_charging_profile Removes a previously set charging profile from the charge point.

charge_point_id

string

required

Target charge point identifier.

integer

The chargingProfileId to remove. If omitted, all profiles matching the optional filter fields are cleared.

connector_id

integer

Limit clearing to a specific connector.

charging_profile_purpose

string

Limit clearing to profiles with this purpose.

stack_level

integer

Limit clearing to profiles at this stack level.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/clear_charging_profile \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "id": 101
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "status": "Accepted",
  "sent_at": "2024-03-10T15:20:00Z"
}

Reset charge point

POST /api/v1/ocpp16/reset Sends a reset command to the charge point.

charge_point_id

string

required

Target charge point identifier.

type

string

required

Reset type:

"Soft" — the charge point finishes active sessions before restarting
"Hard" — immediate restart, active sessions are terminated

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/reset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "type": "Soft"
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "type": "Soft",
  "status": "Accepted",
  "sent_at": "2024-03-10T15:25:00Z"
}

Trigger message

POST /api/v1/ocpp16/trigger_message Requests the charge point to send a specific OCPP message immediately, rather than waiting for its scheduled interval.

charge_point_id

string

required

Target charge point identifier.

requested_message

string

required

The OCPP message type to trigger. Valid values: BootNotification, DiagnosticsStatusNotification, FirmwareStatusNotification, Heartbeat, MeterValues, StatusNotification.

connector_id

integer

Required for MeterValues and StatusNotification — specifies which connector to trigger the message for.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/trigger_message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "requested_message": "StatusNotification",
    "connector_id": 1
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "requested_message": "StatusNotification",
  "status": "Accepted",
  "sent_at": "2024-03-10T15:30:00Z"
}

Reserve connector

POST /api/v1/ocpp16/reserve_now Places a reservation on a specific connector for a given user tag, preventing other users from starting sessions until the reservation expires or is cancelled.

charge_point_id

string

required

Target charge point identifier.

connector_id

integer

required

Connector to reserve. Must be > 0.

expiry_date

string

required

ISO 8601 datetime when the reservation expires (e.g. "2024-03-10T17:00:00Z").

id_tag

string

required

RFID tag or user identifier that the reservation is for.

reservation_id

integer

required

A unique integer identifier for this reservation (chosen by you, used to cancel it later).

parent_id_tag

string

Optional parent RFID tag for group reservations.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/reserve_now \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "connector_id": 1,
    "expiry_date": "2024-03-10T17:00:00Z",
    "id_tag": "RFID-USER-4A2F",
    "reservation_id": 5001
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "connector_id": 1,
  "reservation_id": 5001,
  "status": "Accepted",
  "expires_at": "2024-03-10T17:00:00Z",
  "sent_at": "2024-03-10T15:35:00Z"
}

Possible statuses from the charge point: Accepted, Faulted, Occupied, Rejected, Unavailable.

Cancel reservation

POST /api/v1/ocpp16/cancel_reservation Cancels an existing reservation on a charge point.

charge_point_id

string

required

Target charge point identifier.

reservation_id

integer

required

The reservation_id of the reservation to cancel.

curl -X POST https://api.dynamo-csms.com/api/v1/ocpp16/cancel_reservation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "reservation_id": 5001
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "reservation_id": 5001,
  "status": "Accepted",
  "sent_at": "2024-03-10T15:40:00Z"
}

Get active transactions

GET /api/v1/ocpp16/active_transactions/{charge_point_id} Returns all currently active charging transactions on the specified charge point.

charge_point_id

string

required

The charge point to query.

curl https://api.dynamo-csms.com/api/v1/ocpp16/active_transactions/CP-SITE42-001 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "active_transactions": [
    {
      "transaction_id": 10042,
      "connector_id": 2,
      "id_tag": "RFID-USER-9B3E",
      "start_time": "2024-03-10T14:45:00Z",
      "meter_start": 10500,
      "current_meter_value": 11250,
      "energy_delivered_wh": 750,
      "duration_seconds": 900
    }
  ],
  "total": 1
}

meter_start

integer

Meter reading at session start in Wh.

current_meter_value

integer

Latest meter reading in Wh.

energy_delivered_wh

integer

Energy delivered in this session so far, in Wh.

Get all charge point statuses

GET /api/v1/ocpp16/charge_points/status Returns the current OCPP status of all charge points in your organization. Requires read:charge_points scope.

status

string

Filter by OCPP status: Available, Preparing, Charging, SuspendedEVSE, SuspendedEV, Finishing, Reserved, Unavailable, Faulted.

page

integer

Page number (default: 1).

per_page

integer

Results per page (default: 50, max: 200).

curl "https://api.dynamo-csms.com/api/v1/ocpp16/charge_points/status?status=Faulted" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "charge_points": [
    {
      "charge_point_id": "CP-SITE42-001",
      "online": true,
      "last_heartbeat_at": "2024-03-10T15:58:30Z",
      "connectors": [
        {
          "connector_id": 1,
          "status": "Available",
          "error_code": "NoError",
          "info": null,
          "timestamp": "2024-03-10T15:55:00Z"
        },
        {
          "connector_id": 2,
          "status": "Faulted",
          "error_code": "GroundFailure",
          "info": "Ground fault detected on connector 2",
          "timestamp": "2024-03-10T15:57:00Z"
        }
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 50
}

Error responses

Status	Code	Meaning
`400`	`validation_error`	Missing or invalid request field
`401`	`unauthorized`	Missing or invalid API key
`403`	`forbidden`	Insufficient scope (`write:charge_points` required for command endpoints)
`404`	`not_found`	Charge point ID not found in your organization
`408`	`timeout`	Charge point did not respond within the timeout window (10s default)
`422`	`charge_point_offline`	Charge point is not currently connected via WebSocket
`422`	`ocpp_rejected`	Charge point returned `Rejected` — check charge point logs
`429`	`rate_limited`	Too many commands — max 10 commands/second per charge point

​Send generic command

​Remote start transaction

​Remote stop transaction

​Change availability

​Set charging profile

​Clear charging profile

​Reset charge point

​Trigger message

​Reserve connector

​Cancel reservation

​Get active transactions

​Get all charge point statuses

​Error responses

Send generic command

Remote start transaction

Remote stop transaction

Change availability

Set charging profile

Clear charging profile

Reset charge point

Trigger message

Reserve connector

Cancel reservation

Get active transactions

Get all charge point statuses

Error responses