Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: CarChat Lead API
version: 1.0.0
description: 'Live dealership inventory with buyer inquiry submission. Reads are free, open CORS, no API key. Built for AI agents shopping on behalf of car buyers. Human docs: https://carchat.io/agents'
servers:
- url: https://carchat.io
tags:
- name: Lead
paths:
/api/lead:
post:
operationId: submitInquiry
summary: Submit a buyer inquiry to a dealership
description: Sends the buyer's contact details and question to the selling dealership, which responds directly, usually within minutes. Agents must have the buyer's explicit consent to share their name and phone number and for the dealership to contact them.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- dealerId
- name
- phone
properties:
dealerId:
type: string
description: From vehicle.dealer.id or /api/v1/dealers
vin:
type: string
description: Vehicle id from search results; omit for a general inquiry
name:
type: string
phone:
type: string
email:
type: string
message:
type: string
source:
type: string
description: Where this inquiry originated, e.g. 'agent'
default: agent
responses:
'200':
description: Inquiry delivered to the dealership
'400':
description: Missing name or phone
'404':
description: Unknown dealerId
tags:
- Lead