NAV Navbar
shell ruby python javascript


Welcome to the Plate recognizer API! You can use our API to access our API endpoints, which can read license plates from images.

We have multiple language bindings. You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Authentication API is only available to registered users. You first have to register and get an API key. It has to be included in all API calls. The HTTP headers must contain:

Authorization: Token API_TOKEN

License Plate Recognition

Read number plates from an image

# gem install multipart-post
require 'net/http/post/multipart'

url = URI.parse('')
path = '/path/to/car.jpg' do |jpg|
  req = url.path,
    "upload" =>, "image/jpeg", path)
  req['Authorization'] = 'Token API_TOKEN'
  res = Net::HTTP.start(, url.port, use_ssl: true) do |http|
# pip install requests
import requests
from pprint import pprint

with open('/path/to/car.jpg', 'rb') as fp:
    response =
        headers={'Authorization': 'Token API_TOKEN'})

curl -F 'upload=@/path/to/car.jpg' \
  -H 'Authorization: Token API_TOKEN' \
const fetch = require('node-fetch');
const FormData = require('form-data');
const fs = require('fs');

let image_path = '/path/to/car.jpg'
let body = new FormData();
body.append('upload', fs.createReadStream(image_path));

fetch("", {
        method: 'POST',
        headers: {
            "Authorization": "Token API_TOKEN"
        body: body
    }).then(res => res.json())
    .then(json => console.log(json))
    .catch((err) => {

Return value

    "box": {
      "xmin": 159,
      "ymin": 169,
      "ymax": 194,
      "xmax": 203
    "plate": "abc123",
    "score": 0.868,
    "dscore": 0.718

This endpoint reads all license plates from an image.

HTTP Request


POST Parameters

Parameter Description
upload The file to be uploaded

JSON Response

The response is a list of all the license plates found in the image. Each license plate has the following elements:

Attribute Description
box Bounding box for the license plate
dscore Score of the plate detection. Range [0, 1].
plate Text of the license plate.
score Score of the plate reader text. Range [0, 1].


Get number of recognition calls done during the current month.

HTTP Request


curl -H 'Authorization: Token API_TOKEN' \

Return value

  "usage": {
    "month": 1,
    "calls": 128,
    "year": 2019
  "total_calls": 2500


Error Code Meaning
403 Forbidden -- Your API key is wrong.
413 Payload Too Large response status code indicates that the request entity is larger than limits defined by our server. See upload limits.