Start Public Charging Session

curl --request POST \
  --url https://app.plugchoice.com/api/v3/public-charging/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "connector_id": 123,
  "email": "<string>"
}
'

{
  "session_token": "<string>",
  "data": {
    "status": "<string>",
    "failure_reason": "<string>",
    "connector_id": 123,
    "connector_status": "<string>",
    "charger": {
      "public_code": "<string>",
      "name": "<string>",
      "online": true
    },
    "pricing": {
      "currency": "<string>",
      "price_per_kwh": 123,
      "start_fee": 123
    },
    "amount_authorized": 123,
    "energy_kwh": "<string>",
    "cost_amount": 123,
    "amount_captured": 123,
    "tax_amount": 123,
    "driver_email": "<string>",
    "created_at": "<string>",
    "authorized_at": "<string>",
    "charging_started_at": "<string>",
    "completed_at": "<string>",
    "captured_at": "<string>"
  },
  "payment": {
    "client_secret": "<string>",
    "publishable_key": "<string>",
    "stripe_account_id": "<string>"
  }
}

POST

public-charging

sessions

Start Public Charging Session

curl --request POST \
  --url https://app.plugchoice.com/api/v3/public-charging/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "connector_id": 123,
  "email": "<string>"
}
'

{
  "session_token": "<string>",
  "data": {
    "status": "<string>",
    "failure_reason": "<string>",
    "connector_id": 123,
    "connector_status": "<string>",
    "charger": {
      "public_code": "<string>",
      "name": "<string>",
      "online": true
    },
    "pricing": {
      "currency": "<string>",
      "price_per_kwh": 123,
      "start_fee": 123
    },
    "amount_authorized": 123,
    "energy_kwh": "<string>",
    "cost_amount": 123,
    "amount_captured": 123,
    "tax_amount": 123,
    "driver_email": "<string>",
    "created_at": "<string>",
    "authorized_at": "<string>",
    "charging_started_at": "<string>",
    "completed_at": "<string>",
    "captured_at": "<string>"
  },
  "payment": {
    "client_secret": "<string>",
    "publishable_key": "<string>",
    "stripe_account_id": "<string>"
  }
}

Starts a public charging session on a charger’s connector and creates the Stripe pre-authorization. This endpoint does not require authentication and is rate limited to 3 requests per minute per IP address. Each charger also accepts a limited number of successful sessions per hour; exceeding it returns 429. Returns 404 if the charger is unknown or does not have public charging available, 400 if the charger is offline, 422 if the connector is unknown, and 409 if the connector is unavailable.

code

string

required

The public code of the charger. Case-insensitive. Maximum 10 characters.

connector_id

integer

required

The connector ID to start charging on. Must be between 1 and 100.

string

The driver’s email address for the receipt. Optional. Must be a valid email, maximum 255 characters.

Response

Returns 201 Created.

session_token

string

The session token. Use it as the {token} path parameter to poll, confirm, stop, or cancel the session. Treat it as a credential.

data

object

The session details.

Show session

status

string

The session status. One of created, authorized, starting, charging, stopping, settling, captured, no_charge, expired, failed, abandoned, capture_failed, requires_review, refunded, written_off.

failure_reason

string

The reason the session failed or was abandoned, if any. May be null.

connector_id

integer

The OCPP connector ID the session runs on.

connector_status

string

The current OCPP status of the connector. One of Available, Charging, Faulted, Finishing, Preparing, Reserved, SuspendedEV, SuspendedEVSE, Unavailable. May be null.

charger

object

The charger the session runs on.

Show charger

public_code

string

The public code of the charger.

name

string

The charger’s display name, falling back to the site name. May be null.

online

boolean

Whether the charger is currently online.

pricing

object

The pricing applied to this session.

Show pricing

currency

string

The three-letter currency code. May be null.

price_per_kwh

integer

The price per kWh in the currency’s minor units (e.g., cents). May be null.

start_fee

integer

The fixed session start fee in the currency’s minor units.

amount_authorized

integer

The pre-authorized hold amount in the currency’s minor units. May be null.

energy_kwh

string

The energy delivered in kWh, as a decimal string. While charging, this is an estimate from the latest meter value. May be null.

cost_amount

integer

The running cost in the currency’s minor units, capped at the authorized amount. May be null.

amount_captured

integer

The final amount captured in the currency’s minor units. May be null.

tax_amount

integer

The tax portion of the captured amount in the currency’s minor units. May be null.

driver_email

string

The driver’s receipt email. May be null.

created_at

string

ISO 8601 timestamp of when the session was created. May be null.

authorized_at

string

ISO 8601 timestamp of when the payment was authorized. May be null.

charging_started_at

string

ISO 8601 timestamp of when charging started. May be null.

completed_at

string

ISO 8601 timestamp of when charging completed. May be null.

captured_at

string

ISO 8601 timestamp of when the payment was captured. May be null.

payment

object

The Stripe payment context used to confirm the pre-authorization in the browser.

Show payment

client_secret

string

The Stripe PaymentIntent client secret. May be null.

publishable_key

string

The Stripe publishable key.

stripe_account_id

string

The connected Stripe account ID for the charger’s team. May be null.

Get Public Charger

Get Public Charging Session

​Response

Response