API/client to the official Czech police database of stolen vehicles

Usage no npm install needed!

<script type="module">
  import policeczVehiclesClient from 'https://cdn.skypack.dev/policecz-vehicles-client';


API/client to the official Czech police database of stolen vehicles

Build Status codecov.io npm version Dependency Status


npm install --save policecz-vehicles-client


The client library provides following methods and returns always a Promise instance.

  • search(string) finds vehicle by either VIN or Registration Number.

Example usage:

var client = require('policecz-vehicles-client');

    .then(response => {
      assert.equal(response.count, 1);

      // do something with results

      var item = response.results[0];
      assert.equal(item.id, 987654321);
      assert.equal(item.class, 'osobní vozidlo');
      assert.equal(item.manufacturer, 'AUDI');
      assert.equal(item.type, 'RS 6');
      assert.equal(item.color, 'červená metalíza');
      assert.equal(item.regno, '9Q91234');
      assert.equal(item.rpw, 'CZ');
      assert.equal(item.vin, 'WUAMMM4F58N901800');
      assert.equal(item.engine, 'ABC123DEF');
      assert.equal(item.productionyear, '2008');
      assert.equal(item.stolendate, '1.3.2012');
      assert.equal(item.url, 'http://aplikace.policie.cz/patrani-vozidla/Detail.aspx?id=987654321');

Response format

Response contains three components:

  • results - array of found entries
  • count - number of entries
  • time - when the request was processed / iso format
{ results:
   [ { id: 987654321
       class: 'osobní vozidlo',
       manufacturer: 'AUDI',
       type: 'RS 6',
       color: 'červená metalíza',
       regno: '9Q91234',
       rpw: 'CZ',
       vin: 'WUAMMM4F58N901800',
       engine: 'ABC123DEF',
       productionyear: '2008',
       stolendate: '1.3.2012',
       url: 'http://aplikace.policie.cz/patrani-vozidla/Detail.aspx?id=987654321' } ],
  count: 1,
  time: '2016-03-07T09:37:41.668Z' }