---
title: "List vehicles"
method: GET
path: "/cases/{case_id}/vehicles"
tags: ["Vehicles"]
---

# List vehicles

`GET /cases/{case_id}/vehicles`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/vehicles`
- Auth: none declared

## Query parameters

- `page` integer
- `per_page` integer
- `vehicle_type` 'automobile' | 'motorcycle' | 'recreational_vehicle' | 'boat' | 'commercial_vehicle' | 'classic_car' | 'trailer' | 'off_highway_vehicle' | 'farm_equipment' | 'aircraft' | 'other'
- `disposition` 'keep' | 'transfer_to_heir' | 'sell' | 'donate' | 'junk' | 'pending_decision'

## Response `200`

List of vehicles.

- object
  - `data` Vehicle[]
    - `id` string
    - `case_id` string
    - `vehicle_type` 'automobile' | 'motorcycle' | 'recreational_vehicle' | 'boat' | 'commercial_vehicle' | 'classic_car' | 'trailer' | 'off_highway_vehicle' | 'farm_equipment' | 'aircraft' | 'other'
    - `year` integer, nullable
    - `make` string, nullable
    - `model` string, nullable
    - `vin` string, nullable: Vehicle Identification Number. Masked in responses (last 6 digits only).
    - `license_plate` string, nullable
    - `registration_state` string, nullable
    - `title_status` 'clean' | 'salvage' | 'rebuilt' | 'lien_present' | 'missing' | 'unknown'
    - `ownership_type` 'sole_owner' | 'joint_owner' | 'transfer_on_death' | 'leased' | 'other'
    - `co_owner_name` string, nullable
    - `estimated_value` number, double, nullable
    - `valuation_source` 'kelley_blue_book' | 'nada' | 'edmunds' | 'appraisal' | 'owner_estimate' | 'null', nullable
    - `lien_holder` string, nullable: Bank or finance company holding the lien.
    - `lien_payoff_amount` number, double, nullable
    - `equity_estimate` number, double, nullable
    - `mileage` integer, nullable
    - `condition` 'excellent' | 'good' | 'fair' | 'poor' | 'null', nullable
    - `location` string, nullable: Where the vehicle is currently located.
    - `disposition` 'keep' | 'transfer_to_heir' | 'sell' | 'donate' | 'junk' | 'pending_decision'
    - `disposition_details` object, nullable
      - `transferred_to` string
      - `sale_price` number, double
      - `sale_date` string, date
      - `buyer_name` string
    - `title_transfer_status` 'not_started' | 'dmv_paperwork_filed' | 'title_transferred' | 'completed'
    - `institution_contact_id` string, nullable
    - `notes` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` PaginationMeta
    - `page` integer
    - `per_page` integer
    - `total_count` integer
    - `total_pages` integer
    - `next_cursor` string, nullable: Opaque cursor for fetching the next page. Pass as the `cursor` query parameter. Null when on the last page.
    - `has_more` boolean: Whether more results exist beyond this page.

## Other responses

- `403`: Insufficient permissions for this case or resource.
- `404`: Resource not found.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)