Get Logistics Recharges

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/logistics/recharges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v1/logistics/recharges"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.dcycle.io/v1/logistics/recharges \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>'

{
  "page": 123,
  "size": 123,
  "total": 123,
  "items": [
    {
      "id": "<string>",
      "vehicle_license_plate": "<string>",
      "vehicle_type": "<string>",
      "fuel_name": "<string>",
      "quantity": 123,
      "unit": "<string>",
      "date": "<string>",
      "co2e": 123,
      "created_at": {},
      "updated_at": {}
    }
  ]
}

GET

logistics

recharges

Get Logistics Recharges

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/logistics/recharges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v1/logistics/recharges"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.dcycle.io/v1/logistics/recharges \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>'

{
  "page": 123,
  "size": 123,
  "total": 123,
  "items": [
    {
      "id": "<string>",
      "vehicle_license_plate": "<string>",
      "vehicle_type": "<string>",
      "fuel_name": "<string>",
      "quantity": 123,
      "unit": "<string>",
      "date": "<string>",
      "co2e": 123,
      "created_at": {},
      "updated_at": {}
    }
  ]
}

Get Logistics Recharges

Retrieve all logistics recharges (fuel consumptions) for your organization with pagination and filtering support.

New API: This endpoint is part of the new API architecture with improved design and maintainability.

Request

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

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

Query Parameters

integer

default:"1"

Page number to retrieveExample: 1

integer

default:"10"

Number of items per page (1-100)Example: 50

string

Search by vehicle license plateExample: 1234-ABC

array[string]

Filter by vehicle type(s)Example: vehicle_type=van_diesel&vehicle_type=rigid_truck

array[string]

Filter by fuel UUID(s)Example: fuel_id=550e8400-e29b-41d4-a716-446655440000

array[string]

Filter by vehicle license plate(s)Example: vehicle_license_plate=1234-ABC

array[string]

Filter by source file UUID(s)Example: file_id=550e8400-e29b-41d4-a716-446655440000

string

Filter by recharge date >= (YYYY-MM-DD)Example: 2024-01-01

string

Filter by recharge date <= (YYYY-MM-DD)Example: 2024-12-31

string

Filter by creation date >= (YYYY-MM-DD)Example: 2024-01-01

string

Filter by creation date <= (YYYY-MM-DD)Example: 2024-12-31

string

Filter by recharge statusExample: active

string

Filter by project UUID (only recharges linked to this project)Example: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Response

integer

Current page number

integer

Number of items per page

integer

Total number of logistics recharges matching the filters

array

Array of logistics recharge objects

Show Logistics Recharge Object

string

Unique identifier for the recharge

string

License plate of the vehicle

string

Type of vehicle (e.g., “van_diesel”)

string

Name of the fuel used

number

Amount of fuel consumed

string

Unit of measurement for the fuel quantity

date

Date of the recharge

number

CO2 equivalent emissions in kilograms

datetime

Timestamp when the recharge was created

datetime | null

Timestamp when the recharge was last updated

Example

curl -X GET "https://api.dcycle.io/v1/logistics/recharges?page=1&size=10&date_from=2024-01-01&date_until=2024-12-31" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

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
}

params = {
    "page": 1,
    "size": 10,
    "date_from": "2024-01-01",
    "date_until": "2024-12-31"
}

response = requests.get(
    "https://api.dcycle.io/v1/logistics/recharges",
    headers=headers,
    params=params
)

result = response.json()
print(f"Total recharges: {result['total']}")
for item in result['items']:
    print(f"  - {item['vehicle_license_plate']}: {item['quantity']} {item['unit']} ({item['co2e']} kg CO2e)")

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
};

const params = {
  page: 1,
  size: 10,
  date_from: '2024-01-01',
  date_until: '2024-12-31'
};

axios.get(
  'https://api.dcycle.io/v1/logistics/recharges',
  { headers, params }
)
.then(response => {
  console.log(`Total recharges: ${response.data.total}`);
  response.data.items.forEach(item => {
    console.log(`  - ${item.vehicle_license_plate}: ${item.quantity} ${item.unit} (${item.co2e} kg CO2e)`);
  });
})
.catch(error => console.error(error));

Successful Response

{
  "page": 1,
  "size": 10,
  "total": 156,
  "items": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "vehicle_license_plate": "1234-ABC",
      "vehicle_type": "van_diesel",
      "fuel_name": "Diesel B7",
      "quantity": 45.5,
      "unit": "liters",
      "date": "2024-11-20",
      "co2e": 120.35,
      "created_at": "2024-11-21T08:30:00Z",
      "updated_at": "2024-11-21T08:30:00Z"
    },
    {
      "id": "a12bc34d-56ef-7890-ghij-klmnopqrstuv",
      "vehicle_license_plate": "5678-XYZ",
      "vehicle_type": "rigid_truck_7.5_12_t_gvw_average_diesel",
      "fuel_name": "Diesel B7",
      "quantity": 120.0,
      "unit": "liters",
      "date": "2024-11-19",
      "co2e": 317.52,
      "created_at": "2024-11-20T14:15:00Z",
      "updated_at": "2024-11-20T14:15:00Z"
    }
  ]
}

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

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

Solution: Verify your API key is valid and active. Get a new one from Settings → API.

422 Validation Error

Cause: Invalid filter parameters

{
  "detail": [
    {
      "loc": ["query", "size"],
      "msg": "ensure this value is less than or equal to 100",
      "type": "value_error"
    }
  ]
}

Solution: Ensure page is a positive integer and size is between 1 and 100. Date parameters must use YYYY-MM-DD format.

Get Logistics Requests

Retrieve logistics shipment requests

Delete Recharge

Delete a single recharge record

Batch Delete Recharges

Delete multiple recharges at once

Generate Report

Generate ISO 14083 emissions report

Get Logistics Hubs Get Packages

​Get Logistics Recharges

​Request

​Headers

​Query Parameters

​Response

​Example

​Successful Response

​Common Errors

​401 Unauthorized

​422 Validation Error

​Related Endpoints

Get Logistics Requests

Delete Recharge

Batch Delete Recharges

Generate Report

Get Logistics Recharges

Request

Headers

Query Parameters

Response

Example

Successful Response

Common Errors

401 Unauthorized

422 Validation Error

Related Endpoints