processFields Method

The method allows you to recognize several fields in a document. The method starts the processing task with the parameters of processing specified in an XML file.

Customize the following request URL according to your application processing location:


The XML file with the parameters of processing is transmitted in the request body. You can use the XSD schema of the XML file to create the file with necessary settings. See also the description of the tags and several examples of XML files with settings in XML Parameters of Field Recognition.

Image files can be uploaded to the task using submitImage method.

Only the task with Submitted, Completed or NotEnoughCredits status can be started using this method.

The result of recognition is returned in XML format. Binary data is returned in Base64 encoding.

Note that this method is most convenient when you process a large number of fields on one page: in this case the price of recognition of all fields on one page does not exceed the price of recognition of a page of A4 size. See details in Billing terms.


Parameter Is required Default value Description
taskId Yes No Specifies the identifier of the task. If the task with the specified identifier does not exist or has been deleted, an error is returned.
description No "" Contains the description of the processing task. Must contain no more that 255 characters.
writeRecognitionVariants No "false"

Specifies whether the recognition variants should be written to the result. It can have either true or false value.

If you set this value to true, additional recognition variants (charRecVariants) appear in the XML result file.

Status codes and response format

General status codes and response format of the method are described in HTTP Status Codes and Response Formats.

The following status codes can be returned when this method is called:

Code Description
200 Successful method call.
450 Incorrect parameters have been passed. One of the following errors occurred:
  • The identifier of the task has not been specified.
  • Incorrect XML file has been transmitted.
  • The task with the specified identifier cannot be started (e.g. it has already been started).
  • Task description length exceeds 255 characters.
  • Exceeded quota to add images. This error is returned if the number of images you have uploaded exceeds the number of images you can process with the credits available on your account plus some threshold. You can resolve this issue by topping up your account or by removing the tasks which have been submitted but have not been processed.
550 An internal program error occurred while processing the image.

Output file format

The output XML file has the following format:

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<document xmlns:xsi=""
    <page index="0">
        <text id="print" left="160" top="349" right="339" bottom="384">
            <line left="167" top="366" right="326" bottom="384">
                <char left="167" top="366" right="180" bottom="382">V</char>
                <char left="182" top="370" right="192" bottom="382">e</char>
                <char left="194" top="370" right="199" bottom="382">r</char>
                <char left="199" top="367" right="205" bottom="382">t</char>
                <char left="206" top="370" right="212" bottom="382">r</char>
                <char left="213" top="370" right="223" bottom="382">a</char>
                <char left="224" top="370" right="234" bottom="384">q</char>
                <char left="236" top="371" right="245" bottom="383">s</char>
                <char left="247" top="371" right="256" bottom="382">n</char>
                <char left="258" top="371" right="268" bottom="383">u</char>
                <char left="270" top="370" right="285" bottom="383">m</char>
                <char left="287" top="370" right="302" bottom="382">
                        <variant charConfidence="22">m</variant>
                        <variant charConfidence="-1">rn</variant>
                <char left="304" top="370" right="314" bottom="382">e</char>
                <char left="316" top="370" right="322" bottom="382">r</char>
                <char left="324" top="370" right="326" bottom="382" suspicious="true">:</char>
        <text id="handprint" left="387" top="1035" right="635" bottom="1089">
            <line left="398" top="1045" right="633" bottom="1089">
                <char left="398" top="1052" right="426" bottom="1088">3</char>
                <char left="423" top="1061" right="455" bottom="1089" suspicious="true">0</char>
                <char left="482" top="1055" right="505" bottom="1089">9</char>
                <char left="507" top="1084" right="512" bottom="1087">.</char>
                <char left="520" top="1058" right="549" bottom="1089">0</char>
                <char left="546" top="1045" right="633" bottom="1089" suspicious="true">5</char>
        <checkmark id="checked" left="883" top="427" right="928" bottom="469">
        <checkmark id="not checked" left="884" top="511" right="928" bottom="554">
        <barcode id="leftBarcode" left="46" top="1048" right="128" bottom="1350">
            <value encoding="Base64">QkYxMDExNQ==</value>

See the XSD schema of the output file.

Have more questions? Submit a request



Please sign in to leave a comment.