---
title: "Request a trade-in appraisal from the listing dealership"
method: POST
path: "/v1/leads/trade-ins"
tags: ["Leads"]
---

# Request a trade-in appraisal from the listing dealership

`POST /v1/leads/trade-ins`

## Request

- Base URL: `https://api.carhandshake.com`
- URL: `https://api.carhandshake.com/v1/leads/trade-ins`
- Auth: none required

## Headers

- `Idempotency-Key` string, required
- `X-Captcha-Token` string

## Request body

- TradeInAppraisal
  - `listing_id` string, uuid, required
  - `customer` union, required
    - object
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
      - `phone` string: Phone number in E.164 or as a 10-digit US/Canada number; stored and delivered as E.164.
      - `preferred_contact` 'email' | 'phone' | 'sms' | 'any'
    - object
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email
      - `phone` string, required: Phone number in E.164 or as a 10-digit US/Canada number; stored and delivered as E.164.
      - `preferred_contact` 'email' | 'phone' | 'sms' | 'any'
  - `consent` Consent, required
    - `accepted` unknown, required
    - `allowed_channels` string[]: Exact dealership-contact grants. Omission is a deprecated email-only compatibility path; phone and SMS are never inferred.
    - `disclosure_version` 'carhandshake-dealer-contact-2026-07-13-v1': Required with explicit allowed_channels. The server-owned disclosure is: By submitting this request, you authorize Car Handshake to share it with the selected dealership and authorize that dealership to contact you only through the communication channels you selected. Consent is not a condition of purchase. Message and data rates may apply to SMS.
    - `text` string: Deprecated display copy. Car Handshake records its own versioned disclosure as consent evidence.
  - `message` string
  - `trade_in` object, required
    - `vin` string
    - `year` integer, required
    - `make` string, required
    - `model` string, required
    - `trim` string
    - `mileage` integer, required
    - `condition` 'excellent' | 'good' | 'fair' | 'poor', required

## Response `202`

Appraisal request accepted for consented delivery

- LeadAcknowledgement
  - `lead_id` string, uuid, required
  - `status` 'received' | 'duplicate', required
  - `dealer` object, required
    - `id` string, uuid, required
    - `name` string, required
  - `message` string, required

## Other responses

- `400`: RFC 9457 problem details
- `404`: RFC 9457 problem details
- `409`: RFC 9457 problem details
- `429`: RFC 9457 problem details

---

[API](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api.md) · [All operations](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api/revisions/0a85bfd1c565?raw)