---
title: "Collateral Score Batch (submit)"
method: POST
path: "/v1/vehicle/collateral-score/batch"
tags: ["Collateral Score"]
---

# Collateral Score Batch (submit)

`POST /v1/vehicle/collateral-score/batch`

## Request

- Base URL: `https://api.carsxe.com`
- URL: `https://api.carsxe.com/v1/vehicle/collateral-score/batch`
- Auth: API key in query parameter `key`

Existing customers on legacy plans: Score up to 500 vehicles asynchronously, e.g. to re-score a loan book. Returns 202 with a `batch_id`; poll `GET` with it, or pass `webhook_url` to receive `collateral_score.batch.completed`. The example VIN `3TMKB5FNXRM012539` is free and never counted. Usage is checked up front for every other vehicle, so a 429 means the remaining quota is smaller than that count. Plans that allow overage are billed one Collateral Score call per vehicle that scores, when the batch completes. Hard-capped and prepaid plans are charged for every vehicle except the example VIN at submit, before the 202. One batch runs per account at a time.

## Request body

- object
  - `vehicles` CollateralScoreRequest[], required
    - `vin` string, required
    - `mileage` integer, required: Current odometer reading in miles.
    - `zip` string, required: US ZIP; its state sets the regional value adjustment.
    - `loan_term_months` integer: Adds `depreciation_forecast.at_loan_maturity`.
  - `webhook_url` string, uri: Public HTTPS URL. Redirects are not followed.

## Response `202`

Batch accepted and processing.

- object
  - `success` boolean
  - `batch_id` string
  - `status` 'processing' | 'completed'
  - `total` integer

## Other responses

- `400`: Invalid `vehicles` (the first bad vehicle is named by index) or `webhook_url`.
- `401`: Missing API key, unknown/disabled API key, or inactive account.
- `404`: The collateral-score API is not enabled for this account.
- `409`: Another batch for this account is still processing. One batch runs per account at a time.
- `429`: API usage limit exceeded for the current billing period.
- `500`: Internal server error.
- `503`: The collateral score is temporarily switched off for all accounts. Nothing was charged; retry later.

## Changes

- **2026-10-23** `ac8fcb028169`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/carsxe/apis/carsxe-api/changes/v1/vehicle/collateral-score/batch/post.md)

---

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