curl -X POST "https://api.dcycle.io/v2/vehicle-consumptions/delete" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}" \
-H "Idempotency-Key: 9e8d7c6b-5a49-4382-a1b0-c9d8e7f6a5b4" \
-H "Content-Type: application/json" \
-d '{"ids": ["4f3e2d1c-0b9a-4876-9543-210fedcba987", "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d"]}'
import os
import uuid
import requests
response = requests.post(
"https://api.dcycle.io/v2/vehicle-consumptions/delete",
headers={
"x-api-key": os.environ["DCYCLE_API_KEY"],
"x-organization-id": os.environ["DCYCLE_ORG_ID"],
"Idempotency-Key": str(uuid.uuid4()), # keep it to retry this same batch
},
json={"ids": ["4f3e2d1c-0b9a-4876-9543-210fedcba987"]},
timeout=60,
)
response.raise_for_status()
print(response.json()["id"])
{
"id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"status": "processing",
"entity_type": "vehicle_consumptions",
"operation": "delete",
"source": "api_bulk",
"counts": { "submitted": 2, "succeeded": 0, "failed": 0 },
"chunks_total": 1,
"chunks_done": 0,
"created_at": "2026-10-19T09:20:31.877Z",
"finished_at": null,
"links": {
"self": "/v2/ingest-jobs/5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"items": "/v2/ingest-jobs/5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a/items"
}
}
{
"type": "https://code.dcycle.io/api-reference/errors#BULK_RECORDS_REJECTED",
"title": "Unprocessable Entity",
"status": 422,
"code": "BULK_RECORDS_REJECTED",
"detail": "1 of the submitted records are invalid; nothing was written.",
"errors": [
{
"source_row_index": 1,
"client_row_id": null,
"error_code": "NOT_FOUND",
"error_params": { "field": "ids", "value": "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d" }
}
],
"rejected": 1,
"request_id": "b2248a31-0f1b-4a7d-83ce-b29bd5977b4c"
}
{ "dry_run": true, "submitted": 2, "valid": 2 }
Delete Vehicle Consumptions (v2)
Delete up to 5,000 vehicle consumptions by id, asynchronously, as an ingest job
POST
/
v2
/
vehicle-consumptions
/
delete
curl -X POST "https://api.dcycle.io/v2/vehicle-consumptions/delete" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}" \
-H "Idempotency-Key: 9e8d7c6b-5a49-4382-a1b0-c9d8e7f6a5b4" \
-H "Content-Type: application/json" \
-d '{"ids": ["4f3e2d1c-0b9a-4876-9543-210fedcba987", "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d"]}'
import os
import uuid
import requests
response = requests.post(
"https://api.dcycle.io/v2/vehicle-consumptions/delete",
headers={
"x-api-key": os.environ["DCYCLE_API_KEY"],
"x-organization-id": os.environ["DCYCLE_ORG_ID"],
"Idempotency-Key": str(uuid.uuid4()), # keep it to retry this same batch
},
json={"ids": ["4f3e2d1c-0b9a-4876-9543-210fedcba987"]},
timeout=60,
)
response.raise_for_status()
print(response.json()["id"])
{
"id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"status": "processing",
"entity_type": "vehicle_consumptions",
"operation": "delete",
"source": "api_bulk",
"counts": { "submitted": 2, "succeeded": 0, "failed": 0 },
"chunks_total": 1,
"chunks_done": 0,
"created_at": "2026-10-19T09:20:31.877Z",
"finished_at": null,
"links": {
"self": "/v2/ingest-jobs/5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"items": "/v2/ingest-jobs/5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a/items"
}
}
{
"type": "https://code.dcycle.io/api-reference/errors#BULK_RECORDS_REJECTED",
"title": "Unprocessable Entity",
"status": 422,
"code": "BULK_RECORDS_REJECTED",
"detail": "1 of the submitted records are invalid; nothing was written.",
"errors": [
{
"source_row_index": 1,
"client_row_id": null,
"error_code": "NOT_FOUND",
"error_params": { "field": "ids", "value": "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d" }
}
],
"rejected": 1,
"request_id": "b2248a31-0f1b-4a7d-83ce-b29bd5977b4c"
}
{ "dry_run": true, "submitted": 2, "valid": 2 }
← Vehicles API
Delete vehicle consumptions by id, together with their emissions. The request checks every id and answers
Request-level errors:
202 Accepted with an ingest job that deletes them in the background. Follow it
with GET /v2/ingest-jobs/{id} or the
ingest_job.finished webhook.
The ids are the ones a create job gives you (each item’s entity_id in
GET /v2/ingest-jobs/{id}/items) or the ids of
List Vehicle Consumptions.
Permanent. Deleted consumptions and their emissions cannot be recovered. Use
dry_run=true first if you are not
sure.Beta. Part of the bulk ingest API, currently in beta. The contract may still change before general availability.
curl -X POST "https://api.dcycle.io/v2/vehicle-consumptions/delete" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}" \
-H "Idempotency-Key: 9e8d7c6b-5a49-4382-a1b0-c9d8e7f6a5b4" \
-H "Content-Type: application/json" \
-d '{"ids": ["4f3e2d1c-0b9a-4876-9543-210fedcba987", "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d"]}'
import os
import uuid
import requests
response = requests.post(
"https://api.dcycle.io/v2/vehicle-consumptions/delete",
headers={
"x-api-key": os.environ["DCYCLE_API_KEY"],
"x-organization-id": os.environ["DCYCLE_ORG_ID"],
"Idempotency-Key": str(uuid.uuid4()), # keep it to retry this same batch
},
json={"ids": ["4f3e2d1c-0b9a-4876-9543-210fedcba987"]},
timeout=60,
)
response.raise_for_status()
print(response.json()["id"])
{
"id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"status": "processing",
"entity_type": "vehicle_consumptions",
"operation": "delete",
"source": "api_bulk",
"counts": { "submitted": 2, "succeeded": 0, "failed": 0 },
"chunks_total": 1,
"chunks_done": 0,
"created_at": "2026-10-19T09:20:31.877Z",
"finished_at": null,
"links": {
"self": "/v2/ingest-jobs/5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"items": "/v2/ingest-jobs/5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a/items"
}
}
{
"type": "https://code.dcycle.io/api-reference/errors#BULK_RECORDS_REJECTED",
"title": "Unprocessable Entity",
"status": 422,
"code": "BULK_RECORDS_REJECTED",
"detail": "1 of the submitted records are invalid; nothing was written.",
"errors": [
{
"source_row_index": 1,
"client_row_id": null,
"error_code": "NOT_FOUND",
"error_params": { "field": "ids", "value": "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d" }
}
],
"rejected": 1,
"request_id": "b2248a31-0f1b-4a7d-83ce-b29bd5977b4c"
}
{ "dry_run": true, "submitted": 2, "valid": 2 }
How it works
- The request checks every id. One that does not exist, belongs to a vehicle outside your organization’s
perimeter or is repeated rejects the whole request with
422, and nothing is deleted. - The job deletes them in the background with their emissions, calculation data and custom column values. A consumption read from a file leaves that file settled once it has no consumption left.
- When every chunk is done the job is
completed(orcompleted_with_errors), andingest_job.finishedis sent with"operation": "delete".
Request
Headers
string
required
Your API key (see Authentication).
string
required
Your organization. The consumptions of its vehicles, and of those of the organizations under it that you can write
to, can be deleted.
string
required
1 to 255 characters, unique per batch. A retry with the same key and body returns the original job (with
Idempotent-Replayed: true); the same key with another body is 422 IDEMPOTENCY_KEY_REUSED, and while the first
request is still being processed 409 IDEMPOTENCY_KEY_IN_PROGRESS.Query Parameters
boolean
default:"false"
Check only: the same
422 for bad ids, nothing deleted, no job; 200 with {"dry_run": true, "submitted": n, "valid": n} when every id is valid.Body Parameters
array[uuid]
required
Vehicle consumption ids, 1 to 5,000, each once.
Response
202 Accepted with the job (entity_type: vehicle_consumptions, operation: delete) and a Location header to it.
GET /v2/ingest-jobs/{id}/items has one item per consumption, in the order
sent; an item is failed with DELETE_FAILED when its consumption was already gone by the time the job reached it.
Errors
Problem details. Per-id codes inerrors[].error_code of a 422 BULK_RECORDS_REJECTED
(source_row_index is the position in ids):
error_code | Cause |
|---|---|
NOT_FOUND | The consumption does not exist or its vehicle is outside your organization’s perimeter (both answer the same). |
DUPLICATE_ID | The consumption is already in the request. |
401 for a missing or invalid API key, 403 LOGGED_USER_NOT_MEMBER when the key’s user is not a
member of the organization, 422 REQUEST_VALIDATION_FAILED for a malformed body (no ids, more than 5,000, no
Idempotency-Key), 422 IDEMPOTENCY_KEY_REUSED, 409 IDEMPOTENCY_KEY_IN_PROGRESS, and 429 beyond the
rate limits.
Limits
| Limit | Value |
|---|---|
| Ids per request | 1 to 5,000 |
| Consumptions per deletion chunk | 200 |
Related Endpoints
Create Vehicle Consumptions (v2)
Create consumptions in bulk
List Vehicle Consumptions
Find the ids to delete
Get Ingest Job
Follow the deletion
List Job Items
The outcome of each id
Was this page helpful?