---
title: "List an order's vehicles"
method: GET
path: "/orders/{orderId}/vehicles"
tags: ["Orders"]
---

# List an order's vehicles

`GET /orders/{orderId}/vehicles`

Returns the caller-owned ordered vehicles under one of the caller's orders, newest first.

## Path parameters

- `orderId` string, required

## Query parameters

- `limit` integer — Page size, 1 to 100.
- `starting_after` string — Return the page after this resource id (newest first).
- `expand[]` string[] — Repeatable. `buyer` includes the buyer (with PII); `payments` includes the buyer’s payments and requires `payments:read`; `payouts` includes the caller’s payouts and requires `payouts:read`.

## Response `200`

A page of ordered vehicles.

- object
  - `data` PurchasedVehicle[], required — unresolved $ref
  - `has_more` boolean, required — True when another page follows the returned one.
  - `next_cursor` string, nullable, required — Pass as `starting_after` to fetch the next page; null when `has_more` is false.

## Other responses

- `400` — The request was malformed or failed validation.
- `401` — Authentication is missing or invalid.
- `403` — The token lacks a required scope.
- `404` — No order matches that id.
- `429` — The rate limit has been exceeded.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.dev/ekho/apis/ekho-api.md) · [All operations](https://skmtc.dev/ekho/apis/ekho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ekho/ekho-api/revisions/2056332cf6b9/schema)