Skip to main content

Start a charging session (with policy evaluation)

POST 
/chargers/:id/actions/remote-start

Initiates a charging session using GridLink's full workflow with policy evaluation, authorization checks, and session management. This is the recommended way to start charging.

Use Cases:

  • Start charging remotely via mobile app or dashboard
  • Initiate scheduled charging sessions
  • Begin charging for specific vehicles or drivers
  • Start sessions with custom charging profiles or power limits
  • Trigger charging as part of automated workflows

What Happens:

  1. Policy Evaluation: Checks authorization, reservations, load limits, access rules
  2. Session Creation: Creates transaction record in GridLink database
  3. OCPP Command: Sends RemoteStartTransaction to charger
  4. Session Tracking: Monitors meter values and session state
  5. Event Publishing: Emits session start events for webhooks/integrations

Policy Checks Performed:

  • ID tag authorization and validity
  • User/vehicle permissions and access rules
  • Connector availability and reservation status
  • Site load balancing and power limits
  • Charging profile constraints
  • Time-based access restrictions

Best Practices:

  • Always provide valid idTag for authorization tracking
  • Specify connectorId to target a specific connector
  • Include chargingProfile for custom power limits
  • Command queues if charger offline, applied on reconnection
  • Use webhooks to monitor session start confirmation
info

This endpoint performs full GridLink policy evaluation. It respects authorization rules, load limits, reservations, and all configured charging policies.

tip

For testing or emergency bypass, use the OCPP Direct endpoint (/ocpp/remote-start). For production use, always use this policy-aware endpoint.

note

If the charger is offline, the command is queued and will be sent when the charger reconnects. Session creation happens immediately.

Request​

Responses​

Standard success response for actions