Skip to main content
GET
/
v1
/
logistics
/
report
/
export
Export Detailed Report
const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/logistics/report/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "processing_job_id": "<string>",
  "message": "<string>"
}

​
Export Detailed Report

Queue an asynchronous line-level logistics export — one row per request leg, including company name, movement/leg/package IDs, origin/destination, distance, load, tkm, vehicle type and kgCO2e. Unlike GET /report, which returns an aggregated ISO 14083 summary inline, this endpoint streams the full detail and is built to scale to organizations with millions of requests. It returns 202 immediately; a background worker generates the file and emails a download link (valid 7 days) when ready.

​
Request

​
Headers

​
x-api-key
string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

​
Query Parameters

​
start_date
string
required
Period start date as a Unix timestamp (seconds)Example: 1735689600
​
end_date
string
required
Period end date as a Unix timestamp (seconds). Must be after start_date. Multi-year ranges are allowed.Example: 1767139200
​
clients[]
string[]
Client name(s) to include. Omit to export the whole organization (all clients).
​
per_client
boolean
default:"false"
If true, generate one file per client (selected, or all) bundled into a single ZIP.
​
output_format
string
default:"csv"
Output file format: excel, csv, or json. Large csv/json exports arrive inside a .zip; Excel is refused above ~5M rows — use csv for very large windows.
​
lang
string
default:"es"
Language for the column headers: es or en.
​
project_id
uuid
Filter the export by project UUID

​
Response (202 Accepted)

​
processing_job_id
string
UUID of the processing job for tracking progress
​
message
string
Confirmation message

​
Example

curl -X GET "https://api.dcycle.io/v1/logistics/report/export?start_date=1735689600&end_date=1767139200&output_format=csv&lang=en" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

​
Successful Response

{
  "processing_job_id": "job-uuid",
  "message": "Logistics report export queued. You will receive an email with the download link when it is ready."
}

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{"detail": "Invalid API key", "code": "INVALID_API_KEY"}

​
404 Not Found

Cause: Organization not found 
{"code": "ORGANIZATION_NOT_FOUND", "detail": "Organization with id=UUID('...') not found"}

​
422 Unprocessable Entity

Cause: Invalid or inverted date range 
{"code": "INVALID_DATE_RANGE", "detail": "start_date and end_date must be Unix timestamps (seconds)."}
Solution: Pass start_date/end_date as Unix timestamps in seconds, with end_date after start_date.

Generate Report

Get the aggregated ISO 14083 summary inline

List Clients

Get available clients for filtering