Bulk Delete Vehicle Consumptions (Organization)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({consumption_ids: {}})
};

fetch('https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete"

payload = { "consumption_ids": {} }
headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "consumption_ids": {}
}
'

{
  "success_count": 123,
  "success_ids": {},
  "failed_count": 123,
  "failed_ids": {},
  "message": "<string>"
}

POST

vehicle_consumptions

bulk-delete

Bulk Delete Vehicle Consumptions (Organization)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({consumption_ids: {}})
};

fetch('https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete"

payload = { "consumption_ids": {} }
headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "consumption_ids": {}
}
'

{
  "success_count": 123,
  "success_ids": {},
  "failed_count": 123,
  "failed_ids": {},
  "message": "<string>"
}

Bulk Delete Vehicle Consumptions (Organization)

Delete multiple consumption records by their IDs in a single call — the consumptions don’t need to belong to the same vehicle. Use this from an “all consumptions” table view where a user has selected specific rows across multiple vehicles.

Permanent Action: Deleting consumption records is permanent and cannot be undone. All associated emissions data will be removed from your organization’s totals.

Consumption IDs that don’t exist, or whose vehicle belongs to a different organization, are reported in failed_ids rather than causing the whole request to fail. Always check failed_count after a 200 response.

Request

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

array[string]

required

Array of consumption record UUIDs to delete, from any vehicle in the organization. Minimum 1, maximum 100,000 IDs per request.Example: ["660e8400-e29b-41d4-a716-446655440000", "770e8400-e29b-41d4-a716-446655440001"]

Response

Returns 200 OK with a JSON summary of the operation.

integer

Number of consumption records successfully deleted

array[string]

UUIDs of successfully deleted consumption records

integer

Number of records that failed to delete

array[string]

UUIDs of records that failed to delete (not found, or owned by a different organization)

string

Human-readable summary of the operation

Example

curl -X POST "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "consumption_ids": [
      "660e8400-e29b-41d4-a716-446655440000",
      "770e8400-e29b-41d4-a716-446655440001"
    ]
  }'

import requests
import os

api_key = os.getenv("DCYCLE_API_KEY")
org_id = os.getenv("DCYCLE_ORG_ID")

headers = {
    "x-api-key": api_key,
    "x-organization-id": org_id,
    "Content-Type": "application/json"
}

payload = {
    "consumption_ids": [
        "660e8400-e29b-41d4-a716-446655440000",
        "770e8400-e29b-41d4-a716-446655440001"
    ]
}

response = requests.post(
    "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete",
    headers=headers,
    json=payload
)

result = response.json()
print(f"Deleted: {result['success_count']}, Failed: {result['failed_count']}")
print(result["message"])

const axios = require('axios');

const apiKey = process.env.DCYCLE_API_KEY;
const orgId = process.env.DCYCLE_ORG_ID;

const headers = {
  'x-api-key': apiKey,
  'x-organization-id': orgId,
  'Content-Type': 'application/json'
};

const payload = {
  consumption_ids: [
    '660e8400-e29b-41d4-a716-446655440000',
    '770e8400-e29b-41d4-a716-446655440001'
  ]
};

axios.post(
  'https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete',
  payload,
  { headers }
)
.then(response => {
  const result = response.data;
  console.log(`Deleted: ${result.success_count}, Failed: ${result.failed_count}`);
  console.log(result.message);
})
.catch(error => console.error(error));

Successful Response

{
  "success_count": 2,
  "success_ids": [
    "660e8400-e29b-41d4-a716-446655440000",
    "770e8400-e29b-41d4-a716-446655440001"
  ],
  "failed_count": 0,
  "failed_ids": [],
  "message": "Successfully deleted 2 vehicle consumption(s)"
}

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

{
  "detail": "Invalid API key",
  "code": "INVALID_API_KEY"
}

422 Validation Error

Cause: Invalid request body (e.g. empty consumption_ids array or exceeding 100,000 IDs)

{
  "detail": [
    {
      "loc": ["body", "consumption_ids"],
      "msg": "ensure this value has at least 1 items",
      "type": "value_error.list.min_items"
    }
  ]
}

List Vehicle Consumptions (Organization)

List all consumptions across every vehicle, with filters

Bulk Delete by Filters (Organization)

Delete every consumption matching the current filters, e.g. an entire uploaded file

Bulk Delete Consumptions

Delete consumptions scoped to a single vehicle

​Bulk Delete Vehicle Consumptions (Organization)

​Request

​Headers

​Body Parameters

​Response

​Example

​Successful Response

​Common Errors

​401 Unauthorized

​422 Validation Error

​Related Endpoints

List Vehicle Consumptions (Organization)

Bulk Delete by Filters (Organization)

Bulk Delete Consumptions

Bulk Delete Vehicle Consumptions (Organization)

Request

Headers

Body Parameters

Response

Example

Successful Response

Common Errors

401 Unauthorized

422 Validation Error

Related Endpoints