Cancel an order

DELETE

orders

{order_id}

Cancel an order

curl --request DELETE \
  --url https://sandbox.api.bahnexpress.fi/v2/orders/{order_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'If-Match: <if-match>'

const options = {
  method: 'DELETE',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>'
  }
};

fetch('https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}"

headers = {
    "Idempotency-Key": "<idempotency-key>",
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

{
  "id": "ord_01k1a2b3c4d5e6f7g8h9j0k1m2",
  "ordered_for": null,
  "customer_reference": "PO-2026-1042",
  "status": "cancelled",
  "pickup_readiness": "preparing",
  "created_at": "2026-07-30T13:00:00Z",
  "updated_at": "2026-07-30T13:10:00Z",
  "pickup": {
    "address": {
      "formatted_address": "Teollisuuskatu 1, 00510 Helsinki, Finland",
      "name": null,
      "address_line_1": "Teollisuuskatu 1",
      "address_line_2": null,
      "postal_code": "00510",
      "city": "Helsinki",
      "country_code": "FI",
      "coordinates": {
        "latitude": 60.188,
        "longitude": 24.951
      }
    },
    "type": "dealership",
    "contact": null,
    "release_code": null,
    "available_from": "2026-08-03T08:00:00+03:00",
    "requested_windows": [],
    "agreed_window": null,
    "eta": null,
    "eta_updated_at": null,
    "actual_at": null
  },
  "delivery": {
    "address": {
      "formatted_address": "Hatanpään valtatie 24, 33100 Tampere, Finland",
      "name": null,
      "address_line_1": "Hatanpään valtatie 24",
      "address_line_2": null,
      "postal_code": "33100",
      "city": "Tampere",
      "country_code": "FI",
      "coordinates": {
        "latitude": 61.489,
        "longitude": 23.766
      }
    },
    "type": "dealership",
    "contact": null,
    "requested_windows": [],
    "agreed_window": null,
    "commitment_deadline_at": null,
    "eta": null,
    "eta_updated_at": null,
    "actual_at": null
  },
  "items": [
    {
      "id": "item_01k1a2b3c4d5e6f7g8h9j0k1m2_primary",
      "role": "primary",
      "status": "awaiting_pickup",
      "vin": "WBA00000000000001",
      "registration_number": null,
      "make": null,
      "model": null,
      "note": null,
      "fuel_type": "unknown",
      "transmission": "unknown",
      "engine_power_kw": null,
      "first_registered_year": null,
      "kerb_weight_kg": null,
      "cmr": "digital",
      "plates": "none",
      "pickup_condition": null,
      "delivery_condition": null,
      "winter_tires": {
        "mounted": false,
        "in_vehicle": false
      }
    }
  ],
  "service_options": {
    "transport_preference": "flexible",
    "inspection": "standard"
  },
  "price": {
    "currency": "EUR",
    "total_cents": 45900,
    "transport_cents": 43900,
    "additional_fees_cents": 2000,
    "trade_in_cents": 0
  },
  "customer_note": null,
  "allowed_actions": [
    "get_files"
  ],
  "revision": "N2f8Kp4Vx1Qa7Js5Dc9Lm3Rw6Ty0Bh8GeUiZoAqCdEs"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials.

Headers

Idempotency-Key

string

required

A unique key for this logical write.

Required string length: 8 - 255

If-Match

string

required

The current order revision inside double quotation marks.

X-Request-Id

string

A caller-supplied request identifier for support.

Required string length: 1 - 255

Path Parameters

order_id

string

required

The order identifier. Stable Bahn order identifier used in every order resource path.

Pattern: ^ord_[a-z0-9]+$

Response

The cancelled order.

Current state of one transport order.

string

required

Stable Bahn order ID. Store it after order creation.

Pattern: ^ord_[a-z0-9]+$

ordered_for

object | null

required

Represented business for a platform order, or null for a direct customer order.

Show child attributes

customer_reference

string | null

required

Reference supplied by your system, or null when none was supplied.

status

enum<string>

required

Current overall order state.

Available options:

accepted,

in_transit,

delivered,

cancelled

pickup_readiness

enum<string>

required

Current seller readiness for pickup.

Available options:

pending,

preparing,

confirmed

created_at

string<date-time>

required

Time when Bahn accepted the order.

updated_at

string<date-time>

required

Time when Bahn last updated the order.

pickup

object

required

Current pickup location, contact, requested timing, agreed timing, ETA, and actual time.

Show child attributes

delivery

object

required

Current delivery location, contact, requested timing, agreed timing, ETA, and actual time.

Show child attributes

items

object[]

required

Primary vehicle and optional trade-in vehicle, each with its own state and handover condition.

Required array length: 1 - 2 elements

Show child attributes

service_options

object

required

Transport and inspection service selected for this order.

Show child attributes

price

object | null

required

Price accepted when the order was created, or null when unavailable.

Show child attributes

customer_note

string | null

required

Order-level note supplied by the customer.

allowed_actions

enum<string>[]

required

Actions currently available to this credential. Use this list to enable order controls.

Operation the current credential can perform on the current order state.

Available options:

update,

cancel,

get_files,

get_inspection_report,

get_tracking

revision

string

required

An opaque order revision. Use this value in the If-Match header for an order change. A live ETA update does not change this value.

⌘I

Cancel an order

curl --request DELETE \
  --url https://sandbox.api.bahnexpress.fi/v2/orders/{order_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'If-Match: <if-match>'

const options = {
  method: 'DELETE',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>'
  }
};

fetch('https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}"

headers = {
    "Idempotency-Key": "<idempotency-key>",
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

{
  "id": "ord_01k1a2b3c4d5e6f7g8h9j0k1m2",
  "ordered_for": null,
  "customer_reference": "PO-2026-1042",
  "status": "cancelled",
  "pickup_readiness": "preparing",
  "created_at": "2026-07-30T13:00:00Z",
  "updated_at": "2026-07-30T13:10:00Z",
  "pickup": {
    "address": {
      "formatted_address": "Teollisuuskatu 1, 00510 Helsinki, Finland",
      "name": null,
      "address_line_1": "Teollisuuskatu 1",
      "address_line_2": null,
      "postal_code": "00510",
      "city": "Helsinki",
      "country_code": "FI",
      "coordinates": {
        "latitude": 60.188,
        "longitude": 24.951
      }
    },
    "type": "dealership",
    "contact": null,
    "release_code": null,
    "available_from": "2026-08-03T08:00:00+03:00",
    "requested_windows": [],
    "agreed_window": null,
    "eta": null,
    "eta_updated_at": null,
    "actual_at": null
  },
  "delivery": {
    "address": {
      "formatted_address": "Hatanpään valtatie 24, 33100 Tampere, Finland",
      "name": null,
      "address_line_1": "Hatanpään valtatie 24",
      "address_line_2": null,
      "postal_code": "33100",
      "city": "Tampere",
      "country_code": "FI",
      "coordinates": {
        "latitude": 61.489,
        "longitude": 23.766
      }
    },
    "type": "dealership",
    "contact": null,
    "requested_windows": [],
    "agreed_window": null,
    "commitment_deadline_at": null,
    "eta": null,
    "eta_updated_at": null,
    "actual_at": null
  },
  "items": [
    {
      "id": "item_01k1a2b3c4d5e6f7g8h9j0k1m2_primary",
      "role": "primary",
      "status": "awaiting_pickup",
      "vin": "WBA00000000000001",
      "registration_number": null,
      "make": null,
      "model": null,
      "note": null,
      "fuel_type": "unknown",
      "transmission": "unknown",
      "engine_power_kw": null,
      "first_registered_year": null,
      "kerb_weight_kg": null,
      "cmr": "digital",
      "plates": "none",
      "pickup_condition": null,
      "delivery_condition": null,
      "winter_tires": {
        "mounted": false,
        "in_vehicle": false
      }
    }
  ],
  "service_options": {
    "transport_preference": "flexible",
    "inspection": "standard"
  },
  "price": {
    "currency": "EUR",
    "total_cents": 45900,
    "transport_cents": 43900,
    "additional_fees_cents": 2000,
    "trade_in_cents": 0
  },
  "customer_note": null,
  "allowed_actions": [
    "get_files"
  ],
  "revision": "N2f8Kp4Vx1Qa7Js5Dc9Lm3Rw6Ty0Bh8GeUiZoAqCdEs"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "instance": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

Authentication

Prices

Files

Orders

Inspections

Tracking

Reports

Sandbox

Webhooks

Authorizations

Headers

Path Parameters

Response