---
title: "Batch look up VINs"
method: POST
path: "/v1/vins"
---

# Batch look up VINs

`POST /v1/vins`

Batch form of the VIN lookup. Send a JSON array of VINs in the request body. Max 100 VINs per request; results preserve input order and include misses (found: false).

## Request body

- object
  - `vins` string[], required — Array of VINs to look up (max 100)

## Response `200`

Per-VIN lookup results in input order

- VinsResponse
  - `requested` integer — Unique VIN count after normalization
  - `results` VinResult[]
    - `vin` string
    - `found` boolean
    - `inspection_count` integer
    - `most_recent` object, nullable
      - `date` string, date
      - `time` string
      - `location` string
      - `state` string
      - `dot_number` string
      - `inspection_id` integer
    - `dots_associated` string[]
    - `inspections` object[]
    - `for_sale` object
      - `listed` boolean
      - `as_truck` object, nullable
      - `as_trailer` object, nullable

## Other responses

- `400` — Invalid parameters
- `401` — Invalid or missing API key
- `429` — Too many requests. Check X-RateLimit-Remaining and Retry-After headers.

---

[API](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) · [All operations](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runalphaloops/alphaloops-fmcsa-carrier-data-api/versions/dcfdb73e5778/schema)