Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cariqa.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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"
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_view": "https://invoice.stripe.com/i/acct_1LKJg9HtgZxQ1KXx/test_YWNjdF8xTEtKZzlIdGdaeFExS1h4LF9VR0lGVXZ1ckhJRFlMaTJPZVoyTzR3R1dsbE81NXJaLDE2NTY3ODcyNA02000P98cfsJ?s=ap",
        "invoice_download": "https://pay.stripe.com/invoice/acct_1LKJg9HtgZxQ1KXx/test_YWNjdF8xTEtKZzlIdGdaeFExS1h4LF9VR0lGVXZ1ckhJRFlMaTJPZVoyTzR3R1dsbE81NXJaLDE2NTY3ODcyNA02000P98cfsJ/pdf?s=ap",
        "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"
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,
  }'
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"
  }'
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"

​
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:
  1. CDR Reception: The charging station operator sends consumption data
  2. Session Update: Final energy consumption, duration, and costs are calculated
  3. Payment Processing: Pre-authorized amount is captured based on actual consumption
  4. Invoice Generation: Detailed invoice with breakdown is created
  5. 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"
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_view": "https://invoice.stripe.com/i/acct_1LKJg9HtgZxQ1KXx/test_YWNjdF8xTEtKZzlIdGdaeFExS1h4LF9VR0lGVXZ1ckhJRFlMaTJPZVoyTzR3R1dsbE81NXJaLDE2NTY3ODcyNA02000P98cfsJ?s=ap",
    "invoice_download": "https://pay.stripe.com/invoice/acct_1LKJg9HtgZxQ1KXx/test_YWNjdF8xTEtKZzlIdGdaeFExS1h4LF9VR0lGVXZ1ckhJRFlMaTJPZVoyTzR3R1dsbE81NXJaLDE2NTY3ODcyNA02000P98cfsJ/pdf?s=ap",
    "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:
  1. Session Initiated (Start Command Sent):
{
  "is_active": true,
  "end_time": null,
  "consumed_energy": "0.000",
  "session_cost": null
}
  1. Active Charging (Energy Consumption Updates):
{
  "is_active": true,
  "end_time": null,
  "consumed_energy": "5.420",
  "session_cost": null
}
  1. Stop Command Sent (Manual or Automatic):
{
  "is_active": false,
  "end_time": null,
  "consumed_energy": "8.750",
  "session_cost": null
}
  1. 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_view": "https://invoice.stripe.com/i/acct_1LKJg9HtgZxQ1KXx/test_YWNjdF8xTEtKZzlIdGdaeFExS1h4LF9VR0lGVXZ1ckhJRFlMaTJPZVoyTzR3R1dsbE81NXJaLDE2NTY3ODcyNA02000P98cfsJ?s=ap",
    "invoice_download": "https://pay.stripe.com/invoice/acct_1LKJg9HtgZxQ1KXx/test_YWNjdF8xTEtKZzlIdGdaeFExS1h4LF9VR0lGVXZ1ckhJRFlMaTJPZVoyTzR3R1dsbE81NXJaLDE2NTY3ODcyNA02000P98cfsJ/pdf?s=ap",
    "invoice_vat": "0.86",
    "invoice_summary": "5.39",
    "invoice_credits": "0.00",
    "invoice_discount": "0.00",
    "currency": "eur"
  }
}
Polling 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
  • Session is complete when end_time is not null