CarsXE
Access the full suite of CarsXE vehicle data APIs — VIN decoding, license plate lookup, market value, vehicle history, safety recalls (VIN, year/make/model, or batch), lien/theft checks, OBD-II diagnostic code decoding, vehicle images, international VIN decoding, Year/Make/Model lookups, YMM options, ownership (Enterprise), and plate/VIN OCR from images. Use this skill any time the user asks about a vehicle by VIN, plate, make/model, or OBD code. Also triggers for: "what's this car worth", "check for recalls", "any recalls on a 2023 Toyota Camry", "check recalls for this list of VINs", "what Toyota models were sold in 2023", "who is the registered owner", "vehicle history report", "decode this plate", "what does check engine code X mean", or any automotive data query. Always use this skill when working with CarsXE APIs — do not guess API behavior without it.
Rank
62
Safety
84
Downloads
1.6k
Updated
Oct 10, 2026
Version
1.2.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.6K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.2.0release · observed Sep 10, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17905cc5nn8xyvtp2qza8kb158773gz:carsxe- Install using `clawhub skill install s17905cc5nn8xyvtp2qza8kb158773gz:carsxe` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/carsxe/carsxe before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-carsxe-carsxe/snapshot"
Documentation
CLAWHUB
147,037 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: carsxe
description: >
Access the full suite of CarsXE vehicle data APIs — VIN decoding, license plate lookup,
market value, vehicle history, safety recalls (VIN, year/make/model, or batch), lien/theft checks,
OBD-II diagnostic code decoding, vehicle images, international VIN decoding, Year/Make/Model
lookups, YMM options, ownership (Enterprise), and plate/VIN OCR from images. Use this skill any
time the user asks about a vehicle by VIN, plate, make/model, or OBD code. Also triggers for:
"what's this car worth", "check for recalls", "any recalls on a 2023 Toyota Camry", "check recalls
for this list of VINs", "what Toyota models were sold in 2023", "who is the registered owner",
"vehicle history report", "decode this plate", "what does check engine code X mean", or any
automotive data query. Always use this skill when working with CarsXE APIs — do not guess API
behavior without it.
version: 1.2.0
homepage: https://api.carsxe.com/docs
---
# CarsXE Skill
CarsXE provides a REST API for comprehensive vehicle data at `https://api.carsxe.com`.
Detailed parameter notes for newer endpoints live in `{baseDir}/references/`.
## API Key
The API key is injected as the `CARSXE_KEY` environment variable. Read it before
making any request:
- Use `process.env.CARSXE_KEY` in Node.js
- Use `$env:CARSXE_KEY` in PowerShell
- Use `$CARSXE_KEY` in bash/zsh
If `CARSXE_KEY` is empty or missing, tell the user to run:
```
openclaw config set skills.entries.carsxe.env.CARSXE_KEY "cxe_live_YOUR_KEY"
```
Then restart the gateway.
Always append `&source=openclaw` to every request.
---
## Quick API Map
| User intent | Endpoint | Method | Key Parameters |
| ------------------------------ | --------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| Decode a VIN / get specs | `GET /specs` | GET | `vin`, optional: `deepdata`, `disableIntVINDecoding` |
| Decode a license plate | `GET /v2/platedecoder` | GET | `plate`, `country` (required), `state`, `district` (optional) |
| Market value | `GET /v2/marketvalue` | GET | `vin`, optional: `state`, `mileage`, `condition` |
| Vehicle history report | `GET /history` | GET | `vin` |
| Vehicle images | `GET /images` | GET | `make`, `moREADME.md
# CarsXE Skill for OpenClaw Access the full suite of [CarsXE](https://api.carsxe.com) vehicle data APIs from [OpenClaw](https://openclaw.ai) — decode VINs, look up license plates, get market values, check history, recalls (VIN, YMM, or batch), YMM options, ownership, liens, OBD codes, and more. Published on ClawHub as [@carsxe/carsxe](https://clawhub.ai/carsxe/carsxe). ## Features | Intent | Endpoint | | --- | --- | | Decode a VIN / specs | `GET /specs` | | License plate lookup | `GET /v2/platedecoder` | | Market value | `GET /v2/marketvalue` | | Vehicle history | `GET /history` | | Vehicle images | `GET /images` | | Safety recalls (VIN) | `GET /v1/recalls` | | Safety recalls (year/make/model) | `GET /v1/recalls-ymm` | | Safety recalls (batch) | `POST/GET /v1/recalls-batch/*` | | Lien & theft | `GET /v1/lien-theft` | | International VIN | `GET /v1/international-vin-decoder` | | Year/Make/Model specs | `GET /v1/ymm` | | YMM options (dropdowns) | `GET /v1/ymm-options` | | Ownership (Enterprise) | `GET /v1/ownership/vin\|person\|address\|zip` | | OBD-II decoder | `GET /obdcodesdecoder` | | VIN OCR | `POST /v1/vinocr` | | Plate OCR | `POST /platerecognition` | The skill is auto-invoked from natural language. Agents call `https://api.carsxe.com` with `key=$CARSXE_KEY` and `source=openclaw` on every request. ## Installation ```bash openclaw skills install carsxe ``` Or from ClawHub: ```bash openclaw skills install @carsxe/carsxe ``` ## Setup Get an API key from the [CarsXE developer dashboard](https://api.carsxe.com/dashboard/developer), then: ```bash openclaw config set skills.entries.carsxe.env.CARSXE_KEY "cxe_live_YOUR_KEY" ``` Restart the OpenClaw gateway after setting the key. ## Usage examples Just describe what you need — OpenClaw selects the endpoint and chains calls when required. - *"What are the specs for VIN WBAFR7C57CC811956?"* → `/specs` - *"Decode California plate 7XER187"* → `/v2/platedecoder` - *"What's this car worth?"* → `/v2/marketvalue` - *"Does this VIN have any recalls?"* → `/v1/recalls` - *"Any recalls on a 2023 Toyota Camry?"* → `/v1/recalls-ymm` - *"Check recalls for this list of VINs"* → `/v1/recalls-batch/*` - *"What Toyota models were sold in 2023?"* → `/v1/ymm-options` - *"Who is the registered owner of this VIN?"* → `/v1/ownership/vin` - *"Check liens and theft for this VIN"* → `/v1/lien-theft` - *"My check engine light shows P0300"* → `/obdcodesdecoder` ## Skill layout ``` SKILL.md # Agent instructions + API map references/api-reference.md # Full endpoint table references/recalls-ymm.md references/recalls-batch.md references/ymm-options.md references/ownership.md ``` ## Docs - Skill listing: [clawhub.ai/carsxe/carsxe](https://clawhub.ai/carsxe/carsxe) - API docs: [api.carsxe.com/docs](https://api.carsxe.com/docs) - OpenClaw install guide: [api.carsxe.com/docs/integrations/openclaw-quickstart](https:
_meta.json
{
"ownerId": "kn7ddzxwc7mqp73zn7yfrbxa0d83fr09",
"slug": "carsxe",
"version": "1.2.0",
"publishedAt": 1789061343295
}references/api-reference.md
# CarsXE API reference (OpenClaw)
**Base URL:** `https://api.carsxe.com`
Append `key=$CARSXE_KEY` and `source=openclaw` on **every** request.
Do **not** call `usPlateDecoder` or `/v1/ownership/phone`.
| Intent | Endpoint | Method | Parameters |
| --- | --- | --- | --- |
| VIN specs | `/specs` | GET | `vin`; optional `deepdata`, `disableIntVINDecoding` |
| Plate decoder | `/v2/platedecoder` | GET | `plate`, `country` (required); optional `state`, `district` |
| Market value | `/v2/marketvalue` | GET | `vin`; optional `state`, `mileage`, `condition` |
| History | `/history` | GET | `vin` |
| Images | `/images` | GET | `make`, `model`; optional `year`, `trim`, `color`, `angle`, `photoType`, `size`, `license`, `transparent` |
| Recalls (VIN) | `/v1/recalls` | GET | `vin` |
| Recalls (YMM) | `/v1/recalls-ymm` | GET | `year`, `make`, `model` |
| Recalls batch submit | `/v1/recalls-batch/submit` | POST | JSON `vins` and/or `csv` / `csvUrl`; optional `webhookUrl` |
| Recalls batch status | `/v1/recalls-batch/status` | GET | `batchId` |
| Recalls batch results | `/v1/recalls-batch/results` | GET | `batchId` |
| Recalls batch download | `/v1/recalls-batch/download` | GET | `batchId` (returns `text/csv`) |
| Lien & theft | `/v1/lien-theft` | GET | `vin` |
| International VIN | `/v1/international-vin-decoder` | GET | `vin` |
| YMM specs | `/v1/ymm` | GET | `year`, `make`, `model`; optional `trim` |
| YMM options | `/v1/ymm-options` | GET | optional `dimension`, `year`, `make`, `model`, `trim` |
| Ownership by VIN | `/v1/ownership/vin` | GET | `vin`; optional `include` |
| Ownership by person | `/v1/ownership/person` | GET | `first_name`, `last_name`, `address`, `zip`; optional `include` |
| Ownership by address | `/v1/ownership/address` | GET | `address`, `zip`; optional `include`, `variant` |
| Ownership by ZIP | `/v1/ownership/zip` | GET | `zip`; optional `gender`, `min_age`, `max_age`, `income`, `page`, `limit`, `include`, `variant` |
| OBD decoder | `/obdcodesdecoder` | GET | `code` |
| VIN OCR | `/v1/vinocr` | POST | JSON `{"image": "<URL>"}` |
| Plate OCR | `/platerecognition` | POST | JSON `{"image": "<URL>"}` |
| Auth validate | `/v1/auth/validate` | GET | `key` |
## Routing
- Recalls: VIN → `/v1/recalls`; year/make/model → `/v1/recalls-ymm`; many VINs → `/v1/recalls-batch/*`
- YMM: dropdowns / "what years was X sold" → `/v1/ymm-options`; full specs → `/v1/ymm`
- Ownership is Enterprise-only and billed per returned record. Street `address` is street only (no city/state).
## Details
- [Recalls by YMM](recalls-ymm.md)
- [Recalls Batch](recalls-batch.md)
- [YMM Options](ymm-options.md)
- [Ownership](ownership.md)references/ownership.md
# Ownership (Enterprise)
Registered owners and residents. Requires an Enterprise `ownership` entitlement. Billed per returned record (`owners` / `matches` / `records`), not per request.
Do **not** call `/v1/ownership/phone`.
`include` is optional: comma-separated `demographics,emails,phones,vehicle_history`. Omit it to get everything. `include` only shapes which sections are shown; it does not change billing.
Street `address` is street only — no city or state (max 100). ZIP is 5-digit US (person/address may be ZIP+4; zip lookup is exactly 5 digits).
HTTP 404 / `error: "no_data"` means no match and is **not** billed. HTTP 401 / entitlement error means the key is not entitled.
## VIN
```
GET https://api.carsxe.com/v1/ownership/vin?key=$CARSXE_KEY&vin={VIN}&source=openclaw[&include={INCLUDE}]
```
Required: 17-character VIN.
## Person
```
GET https://api.carsxe.com/v1/ownership/person?key=$CARSXE_KEY&first_name={FIRST}&last_name={LAST}&address={ADDRESS}&zip={ZIP}&source=openclaw[&include={INCLUDE}]
```
Required: `first_name`, `last_name`, street `address`, `zip`.
## Address
```
GET https://api.carsxe.com/v1/ownership/address?key=$CARSXE_KEY&address={ADDRESS}&zip={ZIP}&source=openclaw[&include={INCLUDE}]
```
Required: street `address`, `zip`.
## ZIP
```
GET https://api.carsxe.com/v1/ownership/zip?key=$CARSXE_KEY&zip={ZIP}&source=openclaw[&gender={GENDER}][&min_age={MIN}][&max_age={MAX}][&income={INCOME}][&page={PAGE}][&limit={LIMIT}][&include={INCLUDE}]
```
Required: 5-digit `zip`. Optional: `gender` (`M` or `F`), `min_age`, `max_age`, `income` (code or label), `page` (default 1), `limit` (default 15, max 100).
Warn before a ZIP search with a high `limit` — one page can bill many units.AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/carsxe/skills/carsxe",
"sourceUrl": "https://clawhub.ai/carsxe/skills/carsxe",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T08:20:25.703Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-carsxe-carsxe/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-carsxe-carsxe/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T08:20:25.703Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.6K downloads",
"href": "https://clawhub.ai/carsxe/carsxe",
"sourceUrl": "https://clawhub.ai/carsxe/carsxe",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T08:20:25.703Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.2.0",
"href": "https://clawhub.ai/carsxe/carsxe",
"sourceUrl": "https://clawhub.ai/carsxe/carsxe",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T17:29:03.295Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-carsxe-carsxe/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-carsxe-carsxe/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.2.0",
"description": "Add recalls-ymm, recalls-batch, ymm-options, and ownership.",
"href": "https://clawhub.ai/carsxe/carsxe",
"sourceUrl": "https://clawhub.ai/carsxe/carsxe",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T17:29:03.295Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
