---
title: "VIN OCR"
method: POST
path: "/v1/vinocr"
tags: ["Recognition"]
---

# VIN OCR

`POST /v1/vinocr`

Extract a VIN from a photo. Send a JSON body containing an `image_url` field with either a URL to an image or a base64-encoded image string.

## Request body

- object
  - `image_url` string, required — URL to an image, or the base64 string of the image.

## Response `200`

VIN extracted from the image.

- object
  - `success` boolean
  - `vin` string
  - `box` object
  - `confidence` number
  - `candidates` object[]

## Other responses

- `400` — Missing API key, missing image, invalid image data, image processing failure, or no text detected.
- `401` — User with this API key is not active.
- `404` — API key not found, or no valid VIN found in the image.
- `429` — API usage limit exceeded for the current billing period.

---

[API](https://skmtc.net/carsxe/apis/carsxe-api.md) · [All operations](https://skmtc.net/carsxe/apis/carsxe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carsxe/carsxe-api/versions/0343df02d7c4/schema)