Integration

Rekor CarCheck® is designed as a REST-based API, allowing you to interact with it using a variety of programming languages and operating systems. API calls can be made using different methods according to your development preferences. This flexibility ensures that you have control over how you interact with the API, enabling seamless integration into your applications.

Data Analysis and Retrieval

One of the key features of Rekor CarCheck® is its ability to analyze vehicle images from multiple sources. You can send vehicle image data from a local machine, server, or any web-based URL to Rekor CarCheck®. Upon receiving the image data, the API performs a comprehensive analysis, extracting information about the license plate and the corresponding vehicle. The results are returned in the form of JSON data, providing you with detailed insights about the recognized license plate and the associated vehicle.

API Endpoints

Rekor CarCheck® offers several endpoints that facilitate different functionalities within the API. Each endpoint serves a specific purpose, allowing you to perform various operations related to license plate recognition and vehicle identification.

Before getting started, you will want to make sure you have your secret key ready to go. Your secret key is available within the Web Dashboard. The following endpoints are available:

post

Send an image for Rekor to analyze and provide metadata back The image is sent as a file using a form data POST

Query parameters

secret_keyanyRequired

The secret key used to authenticate your account. You can view your secret key by visiting https://cloud.openalpr.com/

recognize_vehicleanyOptional

If set to 1, the vehicle will also be recognized in the image This requires an additional credit per request

countryanyRequired

Defines the training data used by Rekor. "us" analyzes North-American style plates. "eu" analyzes European-style plates.

This field is required if using the "plate" task

return_imageanyOptional

If set to 1, the image you uploaded will be encoded in base64 and sent back along with the response

topnanyOptional

The number of results you would like to be returned for plate candidates and vehicle classifications

is_croppedanyOptional

When providing a plate or vehicle that is already cropped,
this performs a recognition against the full crop and does not attempt to localize the plate/vehicle

Body

imagestringRequired

The image file that you wish to analyze

Responses

200

OK

400

Parameter is invalid

401

User not authorized or invalid secret_key

402

Monthly usage limit exceeded

403

Temporary rate-limit exceeded

post

HTTPcURLJavaScriptPython

POST /v3/recognize HTTP/1.1
Host: api.openalpr.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 16

"image='text'"

No content

post

Send an image for Rekor to analyze and provide metadata back The image is sent as a URL. The Rekor service will download the image and process it

Query parameters

image_urlstringRequired

A URL to an image that you wish to analyze

secret_keyanyRequired

The secret key used to authenticate your account. You can view your secret key by visiting https://cloud.openalpr.com/

recognize_vehicleanyOptional

If set to 1, the vehicle will also be recognized in the image This requires an additional credit per request

countryanyRequired

Defines the training data used by Rekor. "us" analyzes North-American style plates. "eu" analyzes European-style plates.

This field is required if using the "plate" task

return_imageanyOptional

If set to 1, the image you uploaded will be encoded in base64 and sent back along with the response

topnanyOptional

The number of results you would like to be returned for plate candidates and vehicle classifications

Responses

200

OK

400

Parameter is invalid

401

User not authorized or invalid secret_key

402

Monthly usage limit exceeded

403

Temporary rate-limit exceeded

post

HTTPcURLJavaScriptPython

POST /v3/recognize_url HTTP/1.1
Host: api.openalpr.com
Accept: */*

No content

post

Send an image for Rekor to analyze and provide metadata back The image is sent as base64 encoded bytes.

Query parameters

secret_keyanyRequired

The secret key used to authenticate your account. You can view your secret key by visiting https://cloud.openalpr.com/

recognize_vehicleanyOptional

If set to 1, the vehicle will also be recognized in the image This requires an additional credit per request

countryanyRequired

Defines the training data used by Rekor. "us" analyzes North-American style plates. "eu" analyzes European-style plates.

This field is required if using the "plate" task

return_imageanyOptional

If set to 1, the image you uploaded will be encoded in base64 and sent back along with the response

topnanyOptional

The number of results you would like to be returned for plate candidates and vehicle classifications

Body

stringOptional

Responses

200

OK

400

Parameter is invalid

401

User not authorized or invalid secret_key

402

Monthly usage limit exceeded

403

Temporary rate-limit exceeded

post

HTTPcURLJavaScriptPython

POST /v3/recognize_bytes HTTP/1.1
Host: api.openalpr.com
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"

No content

get

Get a list of available results for plate and vehicle recognition

Responses

200

ok

application/json

get

HTTPcURLJavaScriptPython

GET /v3/config HTTP/1.1
Host: api.openalpr.com
Accept: */*

200

ok

{
  "vehicle_labels": {
    "bodytype": [
      "sedan-compact"
    ],
    "orientation": [
      45
    ],
    "color": [
      "blue"
    ],
    "make": [
      "volvo"
    ],
    "makemodel": [
      "volvo_v40"
    ],
    "year": [
      "2000-2004"
    ]
  },
  "countries": [
    {
      "code": "us",
      "name": "North America"
    }
  ]
}