Charging Sessions

Session History and Details

List User’s Charging Sessions

curl -X GET "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/",
    headers=headers
)

const response = await fetch('https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

Response includes comprehensive session data:

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "ab7ae756-b663-43b9-a025-40c51dd503d9",
      "start_time": "2026-04-02T13:51:18.754610Z",
      "end_time": "2026-04-02T13:51:28.754611Z",
      "duration": 10,
      "consumed_energy": "10.000",
      "is_active": false,
      "evse_id": "DE*CIQ*EELDF6XWZU41P*2",
      "station_info": {
        "station_name": "EVA Charge",
        "station_address": "Ludwigstraße, 9, 67547, Worms",
        "country": "DE",
        "station_speed": "slow",
        "connector_standard": "IEC_62196_T2",
        "connector_power": 22,
        "support_phone": "+4971134214480",
        "latitude": "49.630383",
        "longitude": "8.368902"
      },
      "is_partner": true,
      "logo_url": "https://storage.googleapis.com/cariqa-cpo-logos/evacharge.png?generation=1739874740770603&md5_hash=8dcf9c9d17149760b1c9033218ed1c19&size=11759",
      "user_facing_session_prices": {
        "kwh_price": "0.54",
        "time_price": null,
        "session_fee": null,
        "blocking_fee": null,
        "starting_fee": null,
        "grace_period_minutes": null,
        "blocking_cap": null,
        "currency": "eur"
      },
      "session_cost": {
        "kwh_cost": "5.39",
        "time_cost": "0.00",
        "session_fee_cost": "0.00",
        "blocking_fee_cost": "0.00",
        "starting_fee_cost": "0.00",
        "invoice_download": "https://connect.cariqa.com/download/?<params>",
        "invoice_vat": "0.86",
        "invoice_summary": "5.39",
        "invoice_credits": "0.00",
        "invoice_discount": "0.00",
        "currency": "eur"
      },
	  "rates": 5
    }
  ]
}

Get Single Session Details

curl -X GET "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN", 
    "Content-Type": "application/json"
}

response = requests.get(
    "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/",
    headers=headers
)

const response = await fetch('https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

Response provides the same detailed session object with complete station information, pricing breakdown, and invoice links.

Patch Single Session Details

Rate the charging session:

curl -X PATCH "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "rates": 5,
  }'

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN", 
    "Content-Type": "application/json"
}

data = {
    "rates": 5,
}

response = requests.patch(
    "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/",
    headers=headers,
	json=data
)

const response = await fetch('https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    rates: 5,
  })
});

Response provides the same detailed session object with complete station information, pricing breakdown, and invoice links.

Start-Stop-CDR Flow

The complete charging lifecycle consists of starting a session, monitoring progress, stopping the session, and receiving the final Charge Detail Record (CDR).

Start Charging Session

Initiate a charging session by providing the EVSE ID and payment method:

curl -X POST "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging/start/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "evse_id": "DE*CIQ*EELDF6XWZU41P*2",
    "payment_method_id": "pm_1TD1M3HtgZxQ1KXx5wMzfx15"
  }'

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

start_data = {
    "evse_id": "DEALLEGO0034232",
    "payment_method_id": "pm_1ABC123DEF456"
}

response = requests.post(
    "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging/start/",
    headers=headers,
    json=start_data
)
session_start = response.json()

const response = await fetch('https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging/start/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    evse_id: 'DEALLEGO0034232',
    payment_method_id: 'pm_1ABC123DEF456'
  })
});

const sessionStart = await response.json();

Response:

{
  "id": "ab7ae756-b663-43b9-a025-40c51dd503d9",
  "start_time": "2026-04-02T13:51:18.754610Z",
  "end_time": null,
  "duration": 0,
  "consumed_energy": "0.000",
  "is_active": true,
  "evse_id": "DE*CIQ*EELDF6XWZU41P*2",
  "station_info": {
    "station_name": "EVA Charge",
    "station_address": "Ludwigstraße, 9, 67547, Worms",
    "country": "DE",
    "station_speed": "slow",
    "connector_standard": "IEC_62196_T2",
    "connector_power": 22,
    "support_phone": "+4971134214480",
    "latitude": "49.630383",
    "longitude": "8.368902"
  },
  "is_partner": true,
  "logo_url": "https://storage.googleapis.com/cariqa-cpo-logos/evacharge.png?generation=1739874740770603&md5_hash=8dcf9c9d17149760b1c9033218ed1c19&size=11759",
  "user_facing_session_prices": {
    "kwh_price": "0.54",
    "time_price": null,
    "session_fee": null,
    "blocking_fee": null,
    "starting_fee": null,
    "grace_period_minutes": null,
    "blocking_cap": null,
    "currency": "eur"
  },
  "session_cost": null,
  "rates": null
}

Stop Charging Session

End the charging session manually by providing the session ID:

curl -X POST "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging/stop/ab7ae756-b663-43b9-a025-40c51dd503d9/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging/stop/ab7ae756-b663-43b9-a025-40c51dd503d9/",
    headers=headers
)
stop_result = response.json()

const response = await fetch('https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging/stop/ab7ae756-b663-43b9-a025-40c51dd503d9/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const stopResult = await response.json();

CDR Processing and Final Receipt

After the charging session ends (either manually stopped or automatically), the system receives a Charge Detail Record (CDR) from the charging network that contains the final consumption and cost data. This process happens automatically in the backend:

CDR Reception: The charging station operator sends consumption data
Session Update: Final energy consumption, duration, and costs are calculated
Payment Processing: Pre-authorized amount is captured based on actual consumption
Invoice Generation: Detailed invoice with breakdown is created
Receipt Availability: Session data includes final costs and invoice links

Retrieve the final session details with complete CDR data:

curl -X GET "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/",
    headers=headers
)
final_session = response.json()

const response = await fetch('https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/charging-sessions/ab7ae756-b663-43b9-a025-40c51dd503d9/', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const finalSession = await response.json();

CDR-Enhanced Response:

{
  "id": "ab7ae756-b663-43b9-a025-40c51dd503d9",
  "start_time": "2026-04-02T13:51:18.754610Z",
  "end_time": "2026-04-02T13:51:28.754611Z",
  "duration": 10,
  "consumed_energy": "10.000",
  "is_active": false,
  "evse_id": "DE*CIQ*EELDF6XWZU41P*2",
  "station_info": {
    "station_name": "EVA Charge",
    "station_address": "Ludwigstraße, 9, 67547, Worms",
    "country": "DE",
    "station_speed": "slow",
    "connector_standard": "IEC_62196_T2",
    "connector_power": 22,
    "support_phone": "+4971134214480",
    "latitude": "49.630383",
    "longitude": "8.368902"
  },
  "is_partner": true,
  "logo_url": "https://storage.googleapis.com/cariqa-cpo-logos/evacharge.png?generation=1739874740770603&md5_hash=8dcf9c9d17149760b1c9033218ed1c19&size=11759",
  "user_facing_session_prices": {
    "kwh_price": "0.54",
    "time_price": null,
    "session_fee": null,
    "blocking_fee": null,
    "starting_fee": null,
    "grace_period_minutes": null,
    "blocking_cap": null,
    "currency": "eur"
  },
  "session_cost": {
    "kwh_cost": "5.39",
    "time_cost": "0.00",
    "session_fee_cost": "0.00",
    "blocking_fee_cost": "0.00",
    "starting_fee_cost": "0.00",
    "invoice_download": "https://connect.cariqa.com/download/?<params>",
    "invoice_vat": "0.86",
    "invoice_summary": "5.39",
    "invoice_credits": "0.00",
    "invoice_discount": "0.00",
    "currency": "eur"
  },
  "rates": 5
}

Session Status Tracking

The charging session lifecycle is managed through several key fields that change as the session progresses from start to completion: Session Lifecycle States:

Session Initiated (Start Command Sent):

{
  "is_active": true,
  "end_time": null,
  "consumed_energy": "0.000",
  "session_cost": null
}

Active Charging (Energy Consumption Updates):

{
  "is_active": true,
  "end_time": null,
  "consumed_energy": "5.420",
  "session_cost": null
}

Stop Command Sent (Manual or Automatic):

{
  "is_active": false,
  "end_time": null,
  "consumed_energy": "8.750",
  "session_cost": null
}

CDR Received and Processed (Final State):

{
  "is_active": false,
  "end_time": "2026-04-02T13:51:28.754611Z",
  "consumed_energy": "10.000",
  "payg_summary": {
    "kwh_cost": "5.39",
    "time_cost": "0.00",
    "session_fee_cost": "0.00",
    "blocking_fee_cost": "0.00",
    "starting_fee_cost": "0.00",
    "invoice_download": "https://connect.cariqa.com/download/?<params>",
    "invoice_vat": "0.86",
    "invoice_summary": "5.39",
    "invoice_credits": "0.00",
    "invoice_discount": "0.00",
    "currency": "eur"
  }
}

Recommendations:

Poll every 10-30 seconds while is_active: true for real-time updates
Continue polling after is_active: false until end_time is populated but with extended period
Session is complete when end_time is not null
Check error handling guide for Start Charging Session and Stop Charging Session.

Introduction

Use Cases

Guides

API Reference

Session History and Details

List User’s Charging Sessions

Get Single Session Details

Patch Single Session Details

Start-Stop-CDR Flow

Start Charging Session

Stop Charging Session

CDR Processing and Final Receipt

Session Status Tracking

​Session History and Details

​List User’s Charging Sessions

​Get Single Session Details

​Patch Single Session Details

​Start-Stop-CDR Flow

​Start Charging Session

​Stop Charging Session

​CDR Processing and Final Receipt

​Session Status Tracking

Session History and Details

List User’s Charging Sessions

Get Single Session Details

Patch Single Session Details

Start-Stop-CDR Flow

Start Charging Session

Stop Charging Session

CDR Processing and Final Receipt

Session Status Tracking