POST
/
charging_sessions
curl --request POST \
  --url https://api.chargeapi.co/v1/charging_sessions
{
  "id": null,
  "object": null,
  "amount_due": null,
  "authorization": null,
  "charging_station": null,
  "connector": null,
  "country": null,
  "created": null,
  "currency": null,
  "driver": null,
  "energy_consumed": null,
  "fleet": null,
  "payment_method": null,
  "session_ended": null,
  "session_started": null,
  "status": null,
  "updated": null
}

Response

200 - application/json
A newly created charging_session.

A Charging Session represents a real-time or completed EV charging event. It tracks the energy consumed, session duration, billing information, and associations to a driver, vehicle, charging station, and connector.

​
id
string

Unique identifier for the charging session object.

Example:

null

​
object
string

String representing the object’s type. Always charging_session.

Example:

null

​
amount_due
integer

Total cost of the charging session, in the smallest currency unit (e.g., cents).

Example:

null

​
authorization
string | null

ID of the authorization or token used to initiate the session, if applicable.

Example:

null

​
charging_station
string

ID of the charging station where the session occurred.

Example:

null

​
connector
string

ID of the specific connector used during the session.

Example:

null

​
country
string | null

Country code (ISO 3166-1 alpha-2) where the session took place.

Example:

null

​
created
integer

Time when the charging session was created or initialized.

Example:

null

​
currency
string

ISO 4217 three-letter currency code (e.g., usd).

Example:

null

​
driver
string

ID of the driver who initiated the session.

Example:

null

​
energy_consumed
integer

Amount of energy delivered during the session, in watt-hours (Wh).

Example:

null

​
fleet
string

ID of the fleet the driver or session is associated with.

Example:

null

​
payment_method
string

ID of the payment method used to pay for the session.

Example:

null

​
session_ended
integer | null

Time at which the charging session ended, if completed.

Example:

null

​
session_started
integer

Time when the session began and charging started.

Example:

null

​
status
enum<string>

Current status of the session.

Available options:
active,
completed,
cancelled,
failed
Example:

null

​
updated
integer

Time at which the session was last updated.

Example:

null