CAcarsxe
Recalls

Submit a bulk recalls batch

Submit up to 10,000 VINs for asynchronous recall processing. Provide VINs as a JSON array (vins), inline CSV text (csv), or an HTTPS link to a CSV file (csvUrl). Optionally provide a webhookUrl that CarsXE will POST to when the batch finishes. Poll the status endpoint or wait for the webhook, then fetch results.

x402 submissions must use the JSON vins array. The csv and csvUrl forms require CarsXE API-key authentication.

Credit plans: Bulk Recalls uses 2 credits per unique VIN submitted in an accepted batch, whether or not recalls are found. Duplicate VINs count once. Failed lookups and no-data errors do not use credits. See https://carsxe.com/pricing.md.

post/v1/recalls-batch/submit

Request

Request body

vinsstring[]

Array of 17-character VINs (max 10,000 per batch).

csvstring

Inline CSV text containing VINs. Available with CarsXE API-key authentication only; x402 does not accept this form.

csvUrlstring

HTTPS link to a CSV file of VINs (max 5 MB) hosted on a supported storage provider (e.g. S3, GCS, Firebase, Dropbox). Available with CarsXE API-key authentication only; x402 does not accept this form.

webhookUrlstring

HTTPS URL for a customer webhook. CarsXE POSTs a JSON payload when the batch finishes. Must be a valid HTTPS URL allowed by CarsXE validation rules.

Response

Batch accepted and queued for processing.

successboolean
messagestring

Changes

No recorded changes to this operation across all 9 revisions of this API.