Developer resources
Developer tools

Clear the station's charging profiles of a purpose

post/v1/tenants/{tenant_id}/stations/{station_id}/charging-profiles/clear
Requires an API key

ClearChargingProfile by criteria: every profile of purpose on the station, optionally only one connector's (its EVSE on OCPP 2.x) or one stack level, including profiles set outside this API. result.profile_ids lists the API's profiles it covers; they read cleared once the charger answers Accepted or Unknown. Requires stations:control. The operation succeeds when the core sent the message; result.charger_status then carries the charger's own answer once it arrives (null until then: poll the operation or subscribe to the charging_profile webhooks; it is never resent). Like station commands other than stop and unlock, it answers 402 payment_method_required when the project's billing team has no usable payment method for Ivora's usage fee (no operation; a retry with a journaled Idempotency-Key replays it).

Path parameters

  • tenant_idintegerRequired
  • station_idintegerRequired

Headers

  • idempotency-keystringRequired

Request body

  • purposeenumRequired
    Clear every profile of this purpose on the station, the API's and any other
    One of charger_max, tx_default, session
  • connector_idinteger | null
    Only those of this connector (its EVSE on OCPP 2.x); omit for every connector and the station
    Greater than 0
  • stack_levelinteger | null
    Only those at this stack level
    Minimum 0 · Maximum 100

Returns · 202

  • idstringRequired
  • tenant_idintegerRequired
  • statusenumRequired
    One of dispatching, succeeded, rejected, unknown
  • resultobject | nullRequired
  • created_atstringRequired
  • updated_atstringRequired
POST /v1/tenants/{tenant_id}/stations/{station_id}/charging-profiles/clear
curl --fail-with-body -X POST "https://api.ivoracharge.com/v1/tenants/1042/stations/1/charging-profiles/clear" \
  -H "Authorization: Bearer $IVORA_API_KEY" \
  -H "Idempotency-Key: order-2026-09-30-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "purpose": "charger_max"
}'
Response · 202
{
  "id": "id_0123456789abcdef",
  "tenant_id": 1042,
  "status": "dispatching",
  "result": {},
  "created_at": "2026-09-30T17:00:00Z",
  "updated_at": "2026-09-30T17:00:00Z"
}
Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.