The Ministry of Interior of the Czech Republic

Invalid documentsInvalid documents


Invalid documents in XML format on file Czech Republic

Data from databases in the XML format is intended mainly for programmers who want to incorporate search results into their own programs, for example for automated verification of numbers entered in forms, etc. This format allows simpler and more definite presentation of data than traditional methods. The program does not have to be revised when the application's graphic design is changed.

Query format:

Queries have to be sent to http://www.mvcr.cz/vozidla/doklady/doklady.php using the GET method (queries are part of the URL address). Queries must contain the following items:

ItemDescription
dotazContains the entire document number. If applicable, the series code can be inserted before or after the number. Not case-sensitive. The program ignores spaces, hyphens, and other similar characters.
dokladContains the entire document number. If applicable, the series code can be inserted before or after the number. Not case-sensitive. The program ignores spaces, hyphens, and other similar characters.
xmlDetermines whether the results are shown in a format suitable for being read by a person or intended to be used by a computer program. In the case of no stated value, an empty string, the value “0” (zero), or “off”, the results will be in the html format (suitable for being read by a person). The values “1” (one) and “on” mean that the results will be in the XML format which is suitable for processing by computer programs.

For example, http://www.mvcr.cz/vozidla/doklady/doklady.php?dotaz=123456AB&doklad=0&xml=1 is a query about an identification card number 123456 series code AB. You can view the results by clicking on the link if you have MS Internet Explorer 5 or higher. In the Mozilla browser, you have to enter the command Show Source after clicking on the link.

Reply format (if no error occurs)

<?xml version="1.0" ?>
<doklady_neplatne   posl_zmena="day.month.year"   pristi_zmeny="brief notice (Czech)">
      <dotaz   typ="document type"   cislo="document number"   serie="document series code"/>
      <odpoved   aktualizovano="day.month.year"   evidovano="ano/ne (yes/no)"/>
</doklady_neplatne>

ItemDescription
posl_zmenaDate of last change in the program (not data) in the “day.month.year” format. The month value is a number from 1 (January) to 12 (December). Spaces can but do not have to be used before and after dots.
pristi_zmenyA very short notice of any future change in the program (Czech).
typDocument type. The values “OP” and “OPs” are used for identification cards with (older type) and without (newer) a series code, respectively. Centrally issued passports (purple) are marked “CD”, regionally issued passports (green) are marked “CDr”.
cisloDocument number (without a series code)
serieDocument series code, if applicable. If no series code is used for the given document type, the series code attribute will be assigned a hyphen (series serie="-")
aktualizovanoDate of last update of the list of documents (the applicable type). The date is in the “day.month.year” format, where the month value is a number from 1 (January) to 12 (December). Spaces can but do not have to be used before and after dots.
evidovanoDetermines whether the requested document was found among invalid documents. It can have the value “ano” (“yes” - document was found in the database of invalid documents) or “ne” (“no” - document was not found in the database of invalid documents).
Notice: UTF-8 (Unicode) coding is used for any ASCII characters.

Reply format (if an error occurs)

<?xml version="1.0" ?>
<doklady_neplatne   posl_zmena="day.month.year"   pristi_zmeny="brief notice (Czech)">
    <chyba   spatny_dotaz="ano/ne (yes/no)">error description</chyba>
</doklady_neplatne>

PoložkaPopis
posl_zmenaDate of last change in the program (not data) in the “day.month.year” format. The month value is a number from 1 (January) to 12 (December). Spaces can but do not have to be used before and after dots.
pristi_zmenyA very short notice of any future change in the program (Czech).
spatny_dotazSpecifies whether the query was entered incorrectly or whether a software error occurred. It can have the value “ano” (“yes” - erroneous query) or “ne” (“no” - correct query).
text chybyError description in a format readable by persons.
Notice: UTF-8 (Unicode) coding is used for any ASCII characters.

Format of document numbers

  • Identification cards without series code (newer type)
    The document number consists of nine digits. The first digit may not be a zero. The document has no series code.
  • Identification cards with series code (older type)
    The document number consists of six digits. The first digit may be a zero. The document has a series code that consists of two letters (no diacritical marks). Some identification cards may have a series code consisting of two letters and two digits (such as AB01). Not case-sensitive.
  • Centrally issued passports (purple)
    The document number consists of eight digits. The first digit may not be a zero. The document has no series code. All centrally issued passports have different numbers. Some passports issued centrally and regionally may have the same number.
  • Regionally issued passports (green)
    The document number consists of seven or eight digits. If the document number consists of eight digits, the first digit may not be a zero. Seven-digit numbers may begin with a zero. The document has no series code. All centrally issued passports have different numbers. Some passports issued centrally and regionally may have the same number.

Known future changes

Identification cards with a series code will expire on December 31, 2005.
Flash news RSSFlash news RSS   HomeHome   BackBack   TopTop   E-mail roomE-mail room
 

The Ministry of Interior and the Police Presidium of the Czech Republic - switchboard: 974 811 111, Police of the Czech Republic - switchboard: 974 821 111
Web: breakdowns - 974 801 131, info - 974 841 665, e-mail: webmaster@mvcr.cz;

Technical support: Section of Information Technologies and Communication of the Ministry of Interior, Telefonica O2 Czech Republic a.s., Lira IS
Copyright (c) 2005 - Ministry of Interior, Graphics: Tom Vild, Liv Ducci
All rights reserved