> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bahnexpress.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Order exports

> Export order data with cursor pagination.

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.