Deprecation Notice

Version 2 of the Scan Studio API is deprecated and will be removed on November 25, 2026. Please migrate to the new v3 endpoint for continued support and enhanced features.

Scan Studio

Version 3 (Recommended)

Endpoint

https://api.verifik.co/v3/ocr/scan-studio

The Scan Studio v3 offers enhanced OCR capabilities with improved accuracy and additional features. This version provides more detailed field extraction with normalized values and enhanced confidence scoring.

Headers

Name	Value
Content-Type	`application/json`
Authorization	`Bearer <token>`

Parameters

Name	Type	Required	Description
`image`	string	Yes	Image in Base64 encoded format or a URL where the image is hosted.
`documentType`	string	Yes	The document type you need to scan information from. Supported document types include: `CC`, `RUT`, `PA`, `ENSAPA`, `DNI`, `CCVE`, `RIFVE`, `TLCC`.

Request

Node.js
PHP

const axios = require('axios');
let data = JSON.stringify({
  "image": "/9j/4AAQSkZJRgABAQEASA....AAD/4gIoS=",
  "documentType": "CCVE"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v3/ocr/scan-studio',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJ0w1splt4Cw'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

<?php
$client = new Client();
$headers = [
  'Content-Type' => 'application/json',
  'Authorization' => '••••••'
];
$body = '{
  "image": "/9j/4AAQSkZJRgABAQEA...xbjqiSXFqrqWSutTpCVOELMoqFhH/2Q==",
  "documentType": "CCVE"
}';
$request = new Request('POST', 'https://api.verifik.co/v3/ocr/scan-studio', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Response

{
  "data": {
    "age": "39",
    "client": "68f18d25aafc7dbd2a0bd416",
    "country": "Venezuela",
    "documentCategory": "ID",
    "documentNumber": "18.016.774",
    "documentType": "CCVE",
    "firstNameMatchPercentage": 0,
    "fullNameMatchPercentage": 0,
    "gender": "Male",
    "imageValidated": false,
    "infoValidationSupported": true,
    "inputMethod": "NOT_SET",
    "lastNameMatchPercentage": 0,
    "namesMatch": false,
    "nationality": "VENEZOLANO",
    "OCRExtraction": {
      "details": {
        "fields": [
          {
            "textAnchor": {
              "textSegments": [
                {
                  "startIndex": "167",
                  "endIndex": "174"
                }
              ]
            },
            "type": "civilStatus",
            "mentionText": "SOLTERO",
            "confidence": 0.999997,
            "pageAnchor": {
              "pageRefs": [
                {
                  "boundingPoly": {
                    "normalizedVertices": [
                      {
                        "x": 0.45555556,
                        "y": 0.57798165
                      },
                      {
                        "x": 0.54444444,
                        "y": 0.57798165
                      },
                      {
                        "x": 0.54444444,
                        "y": 0.603211
                      },
                      {
                        "x": 0.45555556,
                        "y": 0.603211
                      }
                    ]
                  }
                }
              ]
            },
            "id": "0"
          },
          {
            "textAnchor": {
              "textSegments": [
                {
                  "startIndex": "156",
                  "endIndex": "166"
                }
              ]
            },
            "type": "dateOfBirth",
            "mentionText": "15/02/1986",
            "confidence": 0.9999982,
            "pageAnchor": {
              "pageRefs": [
                {
                  "boundingPoly": {
                    "normalizedVertices": [
                      {
                        "x": 0.34305555,
                        "y": 0.57798165
                      },
                      {
                        "x": 0.44027779,
                        "y": 0.57798165
                      },
                      {
                        "x": 0.44027779,
                        "y": 0.6055046
                      },
                      {
                        "x": 0.34305555,
                        "y": 0.6055046
                      }
                    ]
                  }
                }
              ]
            },
            "id": "1",
            "normalizedValue": {
              "text": "1986-02-15",
              "dateValue": {
                "year": 1986,
                "month": 2,
                "day": 15
              }
            }
          },
          {
            "textAnchor": {
              "textSegments": [
                {
                  "startIndex": "80",
                  "endIndex": "90"
                }
              ]
            },
            "type": "documentNumber",
            "mentionText": "18.016.774",
            "confidence": 0.99998796,
            "pageAnchor": {
              "pageRefs": [
                {
                  "boundingPoly": {
                    "normalizedVertices": [
                      {
                        "x": 0.43611112,
                        "y": 0.30963302
                      },
                      {
                        "x": 0.55138886,
                        "y": 0.30963302
                      },
                      {
                        "x": 0.55138886,
                        "y": 0.3325688
                      },
                      {
                        "x": 0.43611112,
                        "y": 0.3325688
                      }
                    ]
                  }
                }
              ]
            },
            "id": "2"
          },
          {
            "textAnchor": {
              "textSegments": [
                {
                  "startIndex": "129",
                  "endIndex": "144"
                }
              ]
            },
            "type": "firstName",
            "mentionText": "JOSE DEL CARMEN",
            "confidence": 0.999974,
            "pageAnchor": {
              "pageRefs": [
                {
                  "boundingPoly": {
                    "normalizedVertices": [
                      {
                        "x": 0.24583334,
                        "y": 0.40366971
                      },
                      {
                        "x": 0.45555556,
                        "y": 0.40366971
                      },
                      {
                        "x": 0.45555556,
                        "y": 0.43348625
                      },
                      {
                        "x": 0.24583334,
                        "y": 0.43348625
                      }
                    ]
                  }
                }
              ]
            },
            "id": "5"
          },
          {
            "textAnchor": {
              "textSegments": [
                {
                  "startIndex": "65",
                  "endIndex": "77"
                }
              ]
            },
            "type": "lastName",
            "mentionText": "TOVAR RATTIA",
            "confidence": 0.99997365,
            "pageAnchor": {
              "pageRefs": [
                {
                  "boundingPoly": {
                    "normalizedVertices": [
                      {
                        "x": 0.24444444,
                        "y": 0.35321102
                      },
                      {
                        "x": 0.4125,
                        "y": 0.35321102
                      },
                      {
                        "x": 0.4125,
                        "y": 0.38302752
                      },
                      {
                        "x": 0.24444444,
                        "y": 0.38302752
                      }
                    ]
                  }
                }
              ]
            },
            "id": "8"
          },
          {
            "textAnchor": {
              "textSegments": [
                {
                  "startIndex": "245",
                  "endIndex": "255"
                }
              ]
            },
            "type": "nationality",
            "mentionText": "VENEZOLANO",
            "confidence": 0.9999981,
            "pageAnchor": {
              "pageRefs": [
                {
                  "boundingPoly": {
                    "normalizedVertices": [
                      {
                        "x": 0.34305555,
                        "y": 0.82568806
                      },
                      {
                        "x": 0.5763889,
                        "y": 0.82568806
                      },
                      {
                        "x": 0.5763889,
                        "y": 0.86926603
                      },
                      {
                        "x": 0.34305555,
                        "y": 0.86926603
                      }
                    ]
                  }
                }
              ]
            },
            "id": "9"
          }
        ]
      },
      "documentType": "CCVE",
      "civilStatus": "SOLTERO",
      "gender": "Male",
      "dateOfBirth": "15/02/1986",
      "age": 39,
      "documentNumber": "18.016.774",
      "expeditionDate": "22/02/2023",
      "expireDate": "02/2033",
      "firstName": "JOSE DEL CARMEN",
      "fullName": "JOSE DEL CARMEN TOVAR RATTIA",
      "issuingOffice": "117",
      "lastName": "TOVAR RATTIA",
      "nationality": "VENEZOLANO",
      "country": "Venezuela",
      "category": "ID"
    },
    "requiresBackSide": false,
    "scoreValidated": false,
    "status": "ACTIVE_BUT_UNVERIFIED",
    "type": "ocr",
    "url": "https://cdn.verifik.co/ocr/68f18d25aafc7dbd2a0bd416/1761260917592-png",
    "validationMethod": "SCAN_STUDIO",
    "_id": "68fab57f46bb6a2e90510c8b",
    "updatedAt": "2025-10-23T23:08:47.863Z",
    "createdAt": "2025-10-23T23:08:47.863Z",
    "__v": 0
  },
  "signature": {
    "dateTime": "October 23, 2025 11:08 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "GR48F"
}

{
  "error": "Invalid request"
}

{
    "code": "MissingParameter",
    "message": "documentType must be one of: [CC,RUT,PA,ENSAPA,DNI,CCVE,RIFVE,TLCC]"
}

Version 2 (Deprecated)

Deprecated

This version is deprecated and will be removed on November 25, 2026. Please migrate to v3 for continued support.

Endpoint

https://api.verifik.co/v2/ocr/scan-studio

The Scan Studio offers a seamless and efficient solution for extracting critical information from scanned documents through state-of-the-art Optical Character Recognition (OCR) technology. To use this service, simply provide the document image in Base64-encoded format or a URL where the image is hosted, and let our system handle the rest.

Powered by advanced OCR technology, the Scan Studio accurately extracts and interprets data from a wide variety of scanned documents, delivering the extracted information as structured OCR text accompanied by corresponding labels for easy integration and use. This ensures that users can quickly access and utilize the data in a format that suits their needs.

To ensure the highest levels of data accuracy and reliability, all extracted information undergoes a rigorous validation and verification process. Each field is evaluated, with a clear status indicator showing whether the OCR prediction was accurate, giving users confidence in the quality of the results.

Note: The Scan Studio leverages pre-trained models developed by Verifik, which have been fine-tuned for exceptional performance. This results in faster response times and superior accuracy in data extraction, setting a new standard for reliability in document processing.

Examples of ID's

Headers

Name	Value
Content-Type	`application/json`
Authorization	`Bearer <token>`

Parameters

Name	Type	Required	Description
`image`	string	Yes	Image in Base64 encoded format or a URL where the image is hosted.
`documentType`	string	Yes	The document type you need to scan information from. Supported document types include: `CC`, `RUT`, `PA`, `ENSAPA`, `DNI`, `CCVE`, `RIFVE`, `TLCC`.

Request

Node.js
PHP

const axios = require('axios');
let data = JSON.stringify({
  "image": "/9j/4AAQSkZJRgABAQEASA....AAD/4gIoS=",
  "documentType": "CC"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v2/ocr/scan-studio',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJ0w1splt4Cw'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

<?php
$client = new Client();
$headers = [
  'Content-Type' => 'application/json',
  'Authorization' => '••••••'
];
$body = '{
  "image": "/9j/4AAQSkZJRgABAQEA...xbjqiSXFqrqWSutTpCVOELMoqFhH/2Q==",
  "documentType": "CC"
}';
$request = new Request('POST', 'https://api.verifik.co/v2/ocr/scan-studio', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Response

{
  "data": {
    "age": "39",
    "client": "68f18d25aafc7dbd2a0bd416",
    "documentCategory": "Unknown",
    "documentNumber": "18.016.774",
    "documentType": "CCVE",
    "firstNameMatchPercentage": 0,
    "fullNameMatchPercentage": 0,
    "gender": "Male",
    "imageValidated": false,
    "infoValidationSupported": true,
    "inputMethod": "NOT_SET",
    "lastNameMatchPercentage": 0,
    "namesMatch": false,
    "nationality": "VENEZOLANO",
    "OCRExtraction": {
      "details": {
        "docType": "VE",
        "boundingRegions": [
          {
            "pageNumber": 1,
            "polygon": [
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 720,
                "y": 0
              },
              {
                "x": 720,
                "y": 436
              },
              {
                "x": 0,
                "y": 436
              }
            ]
          }
        ],
        "spans": [
          {
            "offset": 0,
            "length": 256
          }
        ],
        "fields": {
          "documentNumber": {
            "kind": "string",
            "value": "18.016.774",
            "boundingRegions": [
              {
                "pageNumber": 1,
                "polygon": [
                  {
                    "x": 318,
                    "y": 132
                  },
                  {
                    "x": 395,
                    "y": 133
                  },
                  {
                    "x": 395,
                    "y": 148
                  },
                  {
                    "x": 318,
                    "y": 147
                  }
                ]
              }
            ],
            "content": "18.016.774",
            "spans": [
              {
                "offset": 57,
                "length": 10
              }
            ],
            "confidence": 0.941
          },
          "lastName": {
            "kind": "string",
            "value": "TOVAR RATTIA",
            "boundingRegions": [
              {
                "pageNumber": 1,
                "polygon": [
                  {
                    "x": 179,
                    "y": 150
                  },
                  {
                    "x": 293,
                    "y": 151
                  },
                  {
                    "x": 293,
                    "y": 168
                  },
                  {
                    "x": 179,
                    "y": 167
                  }
                ]
              }
            ],
            "content": "TOVAR RATTIA",
            "spans": [
              {
                "offset": 78,
                "length": 12
              }
            ],
            "confidence": 0.92
          },
          "firstName": {
            "kind": "string",
            "value": "JOSE DEL CARMEN",
            "boundingRegions": [
              {
                "pageNumber": 1,
                "polygon": [
                  {
                    "x": 178,
                    "y": 174
                  },
                  {
                    "x": 326,
                    "y": 174
                  },
                  {
                    "x": 326,
                    "y": 192
                  },
                  {
                    "x": 178,
                    "y": 192
                  }
                ]
              }
            ],
            "content": "JOSE DEL CARMEN",
            "spans": [
              {
                "offset": 129,
                "length": 15
              }
            ],
            "confidence": 0.915
          }
        },
        "confidence": 0.987
      },
      "documentNumber": "18.016.774",
      "lastName": "TOVAR RATTIA",
      "firstName": "JOSE DEL CARMEN",
      "fullName": "JOSE DEL CARMEN TOVAR RATTIA"
    },
    "requiresBackSide": false,
    "scoreValidated": false,
    "status": "ACTIVE_BUT_UNVERIFIED",
    "type": "ocr",
    "url": "https://cdn.verifik.co/ocr/68f18d25aafc7dbd2a0bd416/1761259822044-png",
    "validationMethod": "SCAN_STUDIO",
    "_id": "68fab14516e502ba73138dd9",
    "updatedAt": "2025-10-23T22:50:45.467Z",
    "createdAt": "2025-10-23T22:50:45.467Z",
    "__v": 0
  },
  "signature": {
    "dateTime": "October 23, 2025 10:50 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "5G4EJ",
  "deprecation": {
    "message": "This endpoint is deprecated. Please use the new endpoint instead. This endpoint will be removed on November 25, 2025. Check the documentation for more information.",
    "code": "DEPRECATED",
    "deadline": "2025-11-25 11:59:59",
    "details": {
      "documentation": "https://docs.verifik.co/ocr-engines/scan-studio",
      "endpoint": "https://api.verifik.co/v2/ocr/scan-studio",
      "replacement": "https://api.verifik.co/v3/ocr/scan-studio"
    }
  }
}

{
  "error": "Invalid request"
}

{
    "code": "MissingParameter",
    "message": "documentType must be one of: [CC,RUT,PA,ENSAPA,DNI,CCVE,RIFVE,TLCC]"
}

Key Differences Between v2 and v3

Feature	Version 2	Version 3
Field Structure	Fields organized in `fields` object with `kind`, `value`, `content`, `confidence`	Fields organized as array with `type`, `mentionText`, `confidence`, `textAnchor`, `pageAnchor`
Bounding Regions	Uses `polygon` coordinates with absolute pixel values	Uses `normalizedVertices` with relative coordinates (0-1)
Confidence Scores	Single confidence per field	Enhanced confidence scoring with more precision
Additional Fields	Basic document fields	Additional fields like `country`, `documentCategory`, `nationality`
Normalized Values	Raw extracted text only	Includes `normalizedValue` for dates and other structured data
Response Structure	Includes `age`, `gender` fields	Also includes `age`, `gender` fields plus `country`, `documentCategory`
Field Identification	Uses field names as keys	Uses `id` and `type` for better field identification

Migration Benefits

Enhanced Accuracy: Improved OCR accuracy with better confidence scoring
Better Structure: More organized field data with normalized coordinates
Additional Data: More comprehensive document information extraction
Future-Proof: Active development and support for v3

Features

Pre-trained Models: Leverages pre-trained models developed by Verifik for exceptional performance
High Accuracy: Superior accuracy in data extraction with confidence scores for each field
Structured Data: Returns organized field data with bounding regions and confidence levels
Multiple Document Types: Supports various government-issued IDs and documents
Validation Process: All extracted information undergoes rigorous validation and verification
The cropFace parameter helps improve accuracy by focusing on document content.

Version 3 (Recommended)​

Endpoint​

Headers​

Parameters​

Request​

Response​

Version 2 (Deprecated)​

Endpoint​

Examples of ID's​

Headers​

Parameters​

Request​

Response​

Key Differences Between v2 and v3​

Migration Benefits​

Features​

Version 3 (Recommended)

Endpoint

Headers

Parameters

Request

Response

Version 2 (Deprecated)

Endpoint

Examples of ID's

Headers

Parameters

Request

Response

Key Differences Between v2 and v3

Migration Benefits

Features