Get the vehicle inspection report

GET

orders

{order_id}

inspection-report

curl --request GET \
  --url https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}/inspection-report \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}/inspection-report', 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}/inspection-report"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "order_id": "ord_01k1a2b3c4d5e6f7g8h9j0k1m2",
  "item_id": "item_01k1a2b3c4d5e6f7g8h9j0k1m2_primary",
  "status": "available",
  "inspected_at": "2026-08-03T08:42:00+03:00",
  "overall_findings": "One small scratch on the right front door.",
  "items": [
    {
      "category": "body",
      "status": "issue",
      "findings": "Small scratch on the right front door.",
      "evidence": [
        {
          "id": "file_01k1a2b3c4d5e6f7g8h9j0k1m2",
          "item_id": "item_01k1a2b3c4d5e6f7g8h9j0k1m2_primary",
          "kind": "image",
          "category": "vehicle",
          "stage": "pickup",
          "evidence_for": [
            "inspection",
            "damage"
          ],
          "description": null,
          "name": "right-front-door.jpg",
          "media_type": "image/jpeg",
          "size_bytes": 1138201,
          "created_at": "2026-08-03T08:41:00+03:00",
          "content_url": "https://download.example.invalid/right-front-door.jpg",
          "content_url_expires_at": "2026-08-03T09:41:00+03:00",
          "can_delete": false
        }
      ]
    },
    {
      "category": "tires",
      "status": "ok",
      "findings": null,
      "evidence": []
    }
  ]
}

{
  "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

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 inspection state and report.

Structured full-inspection result for the primary vehicle.

order_id

string

required

Order that requested the inspection.

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

item_id

string | null

required

The primary order item. This value is null when the order needs no report.

Pattern: ^item_[a-z0-9]+_(primary|trade_in)$

status

enum<string>

required

Current availability of the full inspection report.

Available options:

not_required,

pending,

available

inspected_at

string<date-time> | null

required

Time when the full inspection was completed, or null before completion.

overall_findings

string | null

required

Overall inspector summary, or null when none was recorded.

items

object[]

required

Category-level inspection results. Empty until the report is available.

Show child attributes

⌘I

Get the vehicle inspection report

curl --request GET \
  --url https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}/inspection-report \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.api.bahnexpress.fi/v2/orders/{order_id}/inspection-report', 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}/inspection-report"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "order_id": "ord_01k1a2b3c4d5e6f7g8h9j0k1m2",
  "item_id": "item_01k1a2b3c4d5e6f7g8h9j0k1m2_primary",
  "status": "available",
  "inspected_at": "2026-08-03T08:42:00+03:00",
  "overall_findings": "One small scratch on the right front door.",
  "items": [
    {
      "category": "body",
      "status": "issue",
      "findings": "Small scratch on the right front door.",
      "evidence": [
        {
          "id": "file_01k1a2b3c4d5e6f7g8h9j0k1m2",
          "item_id": "item_01k1a2b3c4d5e6f7g8h9j0k1m2_primary",
          "kind": "image",
          "category": "vehicle",
          "stage": "pickup",
          "evidence_for": [
            "inspection",
            "damage"
          ],
          "description": null,
          "name": "right-front-door.jpg",
          "media_type": "image/jpeg",
          "size_bytes": 1138201,
          "created_at": "2026-08-03T08:41:00+03:00",
          "content_url": "https://download.example.invalid/right-front-door.jpg",
          "content_url_expires_at": "2026-08-03T09:41:00+03:00",
          "can_delete": false
        }
      ]
    },
    {
      "category": "tires",
      "status": "ok",
      "findings": null,
      "evidence": []
    }
  ]
}

{
  "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

Get the vehicle inspection report

Authorizations

Headers

Path Parameters

Response