Order exports - Bahn Customer API

Use GET /v2/reports/orders for bulk exports, finance workflows, and reporting. It is not the best resource for a live order view. The endpoint requires the reports:read scope and returns one report row for each order. Read the order resource when you need the complete current state of one order.

Select report rows

Use created_from and created_to to select a creation-time range. Send RFC 3339 timestamps with an offset. Use page_size to select a page size. The allowed range is 1 to 100.

Read every page

Process data, then read has_more. When has_more is true, send the returned next_cursor in the next request. Use the cursor without modification. Stop when has_more is false. Do not set an arbitrary client-side page limit for a complete export.

Use report fields

Each row groups these fields:

Group	Examples
Identity	Bahn order ID, customer reference, `ordered_for`, and order actor
Vehicle	VIN and registration number
Route	Countries and formatted addresses
Time	Created, available, pickup, and delivery times
Transport	Distance and duration values
Cost	Currency and total cents
Refuel	Refuel occurrence and cost

The ordered_for value identifies the target customer of an ordering-channel order. It is null for a direct customer order. The ordered_by value identifies the API credential for a Customer API order. Treat a missing optional value as unavailable.

⌘I