Charge Points API — Register and Manage Chargers

Register, configure, and manage EV charge points via the Installer and CPO APIs. Covers certificate management, config templates, and connection testing.

Dynamo CSMS provides two charge point management surfaces: the Installer API for field technicians registering and configuring hardware on-site, and the CPO API for Charge Point Operators managing their fleet programmatically. Both surfaces require authentication — installer endpoints use a JWT from the installer login flow, while CPO endpoints use an organization API key.

---

Installer charge points

Register a charge point

POST /api/v1/installer/charge-points

Registers a new charge point with Dynamo CSMS and returns the configuration needed to connect the hardware to the platform via OCPP.

charge_point_id · string · required

Unique identifier for the charge point, typically matching the hardware serial or OCPP identity. Maximum 48 characters, alphanumeric and hyphens only.

model · string · required

Hardware model name (e.g. "ABB Terra AC W22-G5").

vendor · string · required

Hardware manufacturer name (e.g. "ABB").

serial_number · string · required

Physical serial number printed on the unit.

project_id · string · required

The project this charge point belongs to. Projects group charge points by site or deployment.

location · object

Optional GPS coordinates for the charge point.

Show location fields

location.latitude · number

Decimal latitude (e.g. 51.5074).

location.longitude · number

Decimal longitude (e.g. -0.1278).

location.address · string

Human-readable address for display purposes.

cURL

curl -X POST https://api.dynamo-csms.com/api/v1/installer/charge-points \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CP-SITE42-001",
    "model": "ABB Terra AC W22-G5",
    "vendor": "ABB",
    "serial_number": "SN-20240310-001",
    "project_id": "proj_8c2f4e1a",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "address": "10 Downing St, London, UK"
    }
  }'

Response 201 Created

{
  "charge_point_id": "CP-SITE42-001",
  "project_id": "proj_8c2f4e1a",
  "model": "ABB Terra AC W22-G5",
  "vendor": "ABB",
  "serial_number": "SN-20240310-001",
  "status": "registered",
  "ocpp_endpoint": "wss://ocpp.dynamo-csms.com/ocpp16/CP-SITE42-001",
  "registered_at": "2024-03-10T14:00:00Z",
  "location": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "address": "10 Downing St, London, UK"
  }
}

ocpp_endpoint · string

The WebSocket URL to configure on the charge point hardware for OCPP connectivity.

status · string

Initial status is always registered. Progresses through configured, connected, and commissioned.

---

List charge points

GET /api/v1/installer/charge-points

Returns all charge points registered by the authenticated installer.

project_id · string

Filter by project ID.

status · string

Filter by status. One of: registered, configured, connected, commissioned, offline.

page · integer

Page number for pagination (default: 1).

per_page · integer

Results per page (default: 20, max: 100).

curl "https://api.dynamo-csms.com/api/v1/installer/charge-points?project_id=proj_8c2f4e1a&status=connected" \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "charge_points": [
    {
      "charge_point_id": "CP-SITE42-001",
      "model": "ABB Terra AC W22-G5",
      "vendor": "ABB",
      "status": "connected",
      "project_id": "proj_8c2f4e1a",
      "last_seen_at": "2024-03-10T14:55:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

---

Get charge point

GET /api/v1/installer/charge-points/{charge_point_id}

Returns full details for a single charge point.

charge_point_id · string · required

The charge point’s unique identifier.

curl https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001 \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "model": "ABB Terra AC W22-G5",
  "vendor": "ABB",
  "serial_number": "SN-20240310-001",
  "project_id": "proj_8c2f4e1a",
  "status": "commissioned",
  "ocpp_endpoint": "wss://ocpp.dynamo-csms.com/ocpp16/CP-SITE42-001",
  "identity_verified": true,
  "tls_enabled": true,
  "commissioned_at": "2024-03-10T16:30:00Z",
  "last_seen_at": "2024-03-10T17:02:00Z",
  "location": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "address": "10 Downing St, London, UK"
  }
}

---

Update charge point

PUT /api/v1/installer/charge-points/{charge_point_id}

Updates metadata for a registered charge point. You cannot change charge_point_id or serial_number after registration.

charge_point_id · string · required

The charge point’s unique identifier.

model · string

Updated hardware model name.

vendor · string

Updated vendor name.

project_id · string

Move the charge point to a different project.

location · object

Updated location data.

curl -X PUT https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001 \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "location": {
      "latitude": 51.5080,
      "longitude": -0.1290,
      "address": "12 Downing St, London, UK"
    }
  }'

Response 200 OK — returns the full updated charge point object.

---

Delete charge point

DELETE /api/v1/installer/charge-points/{charge_point_id}

Removes a charge point from Dynamo CSMS. The charge point must be offline and not currently in an active session. Historical session and billing data is retained.

charge_point_id · string · required

The charge point’s unique identifier.

curl -X DELETE https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001 \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 204 No Content

---

Certificate management

Generate TLS certificate

POST /api/v1/installer/charge-points/{charge_point_id}/certificates/generate

Generates a TLS client certificate for the charge point. Install this certificate on the hardware to enable mutual TLS authentication on the OCPP WebSocket connection.

charge_point_id · string · required

The charge point’s unique identifier.

validity_days · integer

Certificate validity period in days (default: 365, max: 1095).

curl -X POST https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/certificates/generate \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"validity_days": 365}'

Response 201 Created

{
  "certificate_id": "cert_3b7f9a2c",
  "charge_point_id": "CP-SITE42-001",
  "certificate_pem": "-----BEGIN CERTIFICATE-----\nMIIDazCCAlOgAwIBAgI...\n-----END CERTIFICATE-----",
  "private_key_pem": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0...\n-----END PRIVATE KEY-----",
  "ca_certificate_pem": "-----BEGIN CERTIFICATE-----\nMIIDqTCCApGgAwIBAgI...\n-----END CERTIFICATE-----",
  "issued_at": "2024-03-10T14:05:00Z",
  "expires_at": "2025-03-10T14:05:00Z"
}

The private_key_pem is returned once only — store it securely alongside the certificate.

---

List certificates

GET /api/v1/installer/charge-points/{charge_point_id}/certificates

Lists all certificates issued for a charge point, including expired ones.

curl https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/certificates \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "certificates": [
    {
      "certificate_id": "cert_3b7f9a2c",
      "status": "active",
      "issued_at": "2024-03-10T14:05:00Z",
      "expires_at": "2025-03-10T14:05:00Z"
    }
  ]
}

---

Configuration management

Get config template

GET /api/v1/installer/charge-points/{charge_point_id}/config/template

Returns the default OCPP configuration template for this charge point’s model. Use it as a starting point before customizing.

curl https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/config/template \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "template_id": "tpl_abb_terra_ac_w22",
  "model": "ABB Terra AC W22-G5",
  "parameters": {
    "HeartbeatInterval": 60,
    "MeterValueSampleInterval": 60,
    "ConnectionTimeOut": 60,
    "AuthorizationCacheEnabled": true,
    "LocalAuthListEnabled": true,
    "AllowOfflineTxForUnknownId": false,
    "StopTransactionOnEVSideDisconnect": true
  }
}

---

Customize configuration

POST /api/v1/installer/charge-points/{charge_point_id}/config/customize

Saves a custom OCPP configuration for this charge point, overriding template defaults.

charge_point_id · string · required

The charge point’s unique identifier.

parameters · object · required

Key-value map of OCPP configuration keys to set. Only include the keys you want to override.

curl -X POST https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/config/customize \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "parameters": {
      "HeartbeatInterval": 30,
      "MeterValueSampleInterval": 30,
      "AuthorizationCacheEnabled": false
    }
  }'

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "message": "Configuration saved. Apply it to the hardware using the download endpoint.",
  "updated_parameters": ["HeartbeatInterval", "MeterValueSampleInterval", "AuthorizationCacheEnabled"]
}

---

Download configuration

GET /api/v1/installer/charge-points/{charge_point_id}/config/download

Downloads the final merged configuration (template + customizations) as a JSON file ready to upload to the charge point hardware.

curl https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/config/download \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN" \
  -o CP-SITE42-001-config.json

Response 200 OK — returns application/json with the full configuration object.

---

Connection testing

Test connection

POST /api/v1/installer/charge-points/{charge_point_id}/test-connection

Initiates a connection test by sending a ping to the charge point over OCPP. Use this to verify network reachability before commissioning.

curl -X POST https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/test-connection \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "reachable": true,
  "latency_ms": 42,
  "ocpp_version": "1.6",
  "tested_at": "2024-03-10T14:20:00Z"
}

---

Get connection status

GET /api/v1/installer/charge-points/{charge_point_id}/connection-status

Returns the current real-time connection status of the charge point.

curl https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/connection-status \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "connected": true,
  "last_heartbeat_at": "2024-03-10T14:58:30Z",
  "websocket_state": "open",
  "ip_address": "203.0.113.42"
}

---

Commission charge point

POST /api/v1/installer/charge-points/{charge_point_id}/commission

Marks a charge point as commissioned and live. This transitions the charge point from installer-mode to production operation. Requires the charge point to be connected and all configuration steps to be complete.

curl -X POST https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/commission \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "status": "commissioned",
  "commissioned_at": "2024-03-10T16:30:00Z",
  "message": "Charge point is now live and available for EV drivers."
}

---

Get charge point status

GET /api/v1/installer/charge-points/{charge_point_id}/status

Returns the current operational status of a charge point.

curl https://api.dynamo-csms.com/api/v1/installer/charge-points/CP-SITE42-001/status \
  -H "Authorization: Bearer INSTALLER_ACCESS_TOKEN"

Response 200 OK

{
  "charge_point_id": "CP-SITE42-001",
  "operational_status": "Available",
  "connectors": [
    {
      "connector_id": 1,
      "status": "Available",
      "error_code": "NoError"
    },
    {
      "connector_id": 2,
      "status": "Charging",
      "error_code": "NoError",
      "active_transaction_id": "txn_9a3c1b4d"
    }
  ],
  "last_updated_at": "2024-03-10T17:05:00Z"
}

---

CPO charge points

CPO (Charge Point Operator) endpoints use an organization API key with the write:charge_points or read:charge_points scope.

Create charge point (CPO)

POST /api/v1/chargepoints

Creates a charge point record at the CPO level, for operators managing charge points without going through the installer workflow.

charge_point_id · string · required

Unique charge point identifier.

name · string · required

Display name for the charge point.

latitude · number · required

GPS latitude.

longitude · number · required

GPS longitude.

address · string · required

Physical address of the charge point.

connector_count · integer · required

Number of connectors on this unit.

max_power_kw · number · required

Maximum charging power per connector in kilowatts.

curl -X POST https://api.dynamo-csms.com/api/v1/chargepoints \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_point_id": "CPO-FLEET-099",
    "name": "Car Park Level 2 - Bay 3",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "address": "1 Example St, London, UK",
    "connector_count": 2,
    "max_power_kw": 22.0
  }'

Response 201 Created

{
  "charge_point_id": "CPO-FLEET-099",
  "name": "Car Park Level 2 - Bay 3",
  "status": "offline",
  "created_at": "2024-03-10T14:00:00Z"
}

---

Update charge point (CPO)

PATCH /api/v1/chargepoints/{charge_point_id}

Partially updates a CPO charge point. Only include fields you want to change.

charge_point_id · string · required

The charge point’s unique identifier.

name · string

Updated display name.

address · string

Updated address.

max_power_kw · number

Updated maximum power in kilowatts.

curl -X PATCH https://api.dynamo-csms.com/api/v1/chargepoints/CPO-FLEET-099 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Car Park Level 2 - Bay 3 (Fast)"}'

Response 200 OK — returns the full updated charge point object.

---

Search charge points by proximity

GET /api/v1/chargepoints/search

Returns charge points near a given GPS coordinate, ordered by distance.

latitude · number · required

Center latitude for the proximity search.

longitude · number · required

Center longitude for the proximity search.

radius_km · number

Search radius in kilometers (default: 5, max: 50).

status · string

Filter by connector status: available, occupied, offline.

curl "https://api.dynamo-csms.com/api/v1/chargepoints/search?latitude=51.5074&longitude=-0.1278&radius_km=2&status=available" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "charge_points": [
    {
      "charge_point_id": "CPO-FLEET-099",
      "name": "Car Park Level 2 - Bay 3",
      "distance_km": 0.3,
      "status": "available",
      "available_connectors": 2,
      "max_power_kw": 22.0,
      "latitude": 51.5074,
      "longitude": -0.1278
    }
  ],
  "total": 1
}

---

Get CPO charge point status

GET /api/v1/chargepoints/{charge_point_id}/status

curl https://api.dynamo-csms.com/api/v1/chargepoints/CPO-FLEET-099/status \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "charge_point_id": "CPO-FLEET-099",
  "online": true,
  "operational_status": "Available",
  "last_heartbeat_at": "2024-03-10T17:00:00Z"
}

---

List connectors

GET /api/v1/chargepoints/{charge_point_id}/connectors

curl https://api.dynamo-csms.com/api/v1/chargepoints/CPO-FLEET-099/connectors \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "charge_point_id": "CPO-FLEET-099",
  "connectors": [
    {
      "connector_id": 1,
      "type": "Type2",
      "max_power_kw": 22.0,
      "status": "Available"
    },
    {
      "connector_id": 2,
      "type": "CCS2",
      "max_power_kw": 50.0,
      "status": "Charging"
    }
  ]
}

---

Get tariff

GET /api/v1/chargepoints/{charge_point_id}/tariff

Returns the current pricing tariff applied to this charge point.

curl https://api.dynamo-csms.com/api/v1/chargepoints/CPO-FLEET-099/tariff \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "charge_point_id": "CPO-FLEET-099",
  "tariff": {
    "currency": "GBP",
    "price_per_kwh": 0.35,
    "session_fee": 0.50,
    "idle_fee_per_minute": 0.05,
    "free_idle_minutes": 10,
    "updated_at": "2024-02-01T00:00:00Z"
  }
}

---

Update tariff

PUT /api/v1/chargepoints/{charge_point_id}/tariff

Sets or replaces the tariff for a charge point. Requires write:charge_points scope.

currency · string · required

ISO 4217 currency code (e.g. "GBP", "EUR", "USD").

price_per_kwh · number · required

Price per kilowatt-hour.

session_fee · number

Flat fee charged at session start.

idle_fee_per_minute · number

Per-minute fee charged when a vehicle remains plugged in after charging completes.

free_idle_minutes · integer

Number of idle minutes allowed before idle fees apply.

curl -X PUT https://api.dynamo-csms.com/api/v1/chargepoints/CPO-FLEET-099/tariff \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "GBP",
    "price_per_kwh": 0.38,
    "session_fee": 0.50,
    "idle_fee_per_minute": 0.05,
    "free_idle_minutes": 10
  }'

Response 200 OK — returns the updated tariff object.

---

Search public chargers (no auth)

GET /api/v1/public/chargers

Returns publicly listed charge points. No authentication required. Suitable for driver-facing apps and maps.

latitude · number · required

Center latitude.

longitude · number · required

Center longitude.

radius_km · number

Search radius in kilometers (default: 5, max: 50).

curl "https://api.dynamo-csms.com/api/v1/public/chargers?latitude=51.5074&longitude=-0.1278&radius_km=1"

Response 200 OK

{
  "chargers": [
    {
      "charge_point_id": "CPO-FLEET-099",
      "name": "Car Park Level 2 - Bay 3",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "address": "1 Example St, London, UK",
      "distance_km": 0.3,
      "available_connectors": 2,
      "total_connectors": 2,
      "max_power_kw": 22.0,
      "price_per_kwh": 0.38,
      "currency": "GBP"
    }
  ],
  "total": 1
}

---

Error responses

Status	Code	Meaning
400	validation_error	Required field missing or invalid format
401	unauthorized	Missing or expired token
403	forbidden	Insufficient scope for this operation
404	not_found	Charge point ID does not exist
409	already_exists	A charge point with this ID is already registered
422	active_session	Cannot delete a charge point with an active session
422	not_connected	Operation requires the charge point to be online