Aviso de Deprecación

La versión 2 de la API de Escaneo Estudio está deprecada y será eliminada el 25 de noviembre de 2026. Por favor migre al nuevo endpoint v3 para soporte continuo y características mejoradas.

Escaneo Estudio

Versión 3 (Recomendada)

Endpoint

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

El Escaneo Estudio v3 ofrece capacidades OCR mejoradas con mayor precisión y características adicionales. Esta versión proporciona extracción de campos más detallada con valores normalizados y puntuación de confianza mejorada.

Headers

Nombre	Valor
Content-Type	`application/json`
Authorization	`Bearer <token>`

Parámetros

Parámetro	Tipo	Requerido	Descripción
`image`	string	Sí	Imagen en formato Base64 codificado o una URL donde la imagen está alojada.
`documentType`	string	Sí	El tipo de documento del que necesita escanear información. Tipos de documentos soportados incluyen: `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]"
}

Versión 2 (Deprecada)

Deprecada

Esta versión está deprecada y será eliminada el 25 de noviembre de 2026. Por favor migre a v3 para soporte continuo.

Endpoint

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

El Escaneo Estudio ofrece una solución fluida y eficiente para extraer información crítica de documentos escaneados a través de tecnología de Reconocimiento Óptico de Caracteres (OCR) de última generación. Para usar este servicio, simplemente proporcione la imagen del documento en formato Base64 codificado o una URL donde esté alojada la imagen, y deje que nuestro sistema se encargue del resto.

Impulsado por tecnología OCR avanzada, el Escaneo Estudio extrae e interpreta con precisión datos de una amplia variedad de documentos escaneados, entregando la información extraída como texto OCR estructurado acompañado de etiquetas correspondientes para fácil integración y uso. Esto asegura que los usuarios puedan acceder y utilizar rápidamente los datos en un formato que se adapte a sus necesidades.

Para garantizar los más altos niveles de precisión y confiabilidad de los datos, toda la información extraída pasa por un riguroso proceso de validación y verificación. Cada campo es evaluado, con un indicador de estado claro que muestra si la predicción OCR fue precisa, dando a los usuarios confianza en la calidad de los resultados.

Nota: El Escaneo Estudio aprovecha modelos pre-entrenados desarrollados por Verifik, que han sido ajustados para un rendimiento excepcional. Esto resulta en tiempos de respuesta más rápidos y una precisión superior en la extracción de datos, estableciendo un nuevo estándar de confiabilidad en el procesamiento de documentos.

Ejemplos de ID's

Headers

Nombre	Valor
Content-Type	`application/json`
Authorization	`Bearer <token>`

Parámetros

Parámetro	Tipo	Requerido	Descripción
`image`	string	Sí	Imagen en formato Base64 codificado o una URL donde la imagen está alojada.
`documentType`	string	Sí	El tipo de documento del que necesita escanear información. Tipos de documentos soportados incluyen: `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]"
}

Diferencias Clave Entre v2 y v3

Característica	Versión 2	Versión 3
Estructura de Campos	Campos organizados en objeto `fields` con `kind`, `value`, `content`, `confidence`	Campos organizados como array con `type`, `mentionText`, `confidence`, `textAnchor`, `pageAnchor`
Regiones Delimitadoras	Usa coordenadas `polygon` con valores de píxeles absolutos	Usa `normalizedVertices` con coordenadas relativas (0-1)
Puntuaciones de Confianza	Una confianza por campo	Puntuación de confianza mejorada con mayor precisión
Campos Adicionales	Campos básicos del documento	Campos adicionales como `country`, `documentCategory`, `nationality`
Valores Normalizados	Solo texto extraído en bruto	Incluye `normalizedValue` para fechas y otros datos estructurados
Estructura de Respuesta	Incluye campos `age`, `gender`	También incluye campos `age`, `gender` más `country`, `documentCategory`
Identificación de Campos	Usa nombres de campos como claves	Usa `id` y `type` para mejor identificación de campos

Beneficios de Migración

Precisión Mejorada: Precisión OCR mejorada con mejor puntuación de confianza
Mejor Estructura: Datos de campo más organizados con coordenadas normalizadas
Datos Adicionales: Extracción de información de documentos más completa
Preparado para el Futuro: Desarrollo activo y soporte para v3

Características

Modelos Pre-entrenados: Aprovecha modelos pre-entrenados desarrollados por Verifik para un rendimiento excepcional
Alta Precisión: Precisión superior en la extracción de datos con puntuaciones de confianza para cada campo
Datos Estructurados: Devuelve datos de campo organizados con regiones delimitadoras y niveles de confianza
Múltiples Tipos de Documentos: Soporte para varias identificaciones emitidas por el gobierno y documentos
Proceso de Validación: Toda la información extraída pasa por un riguroso proceso de validación y verificación
El parámetro cropFace ayuda a mejorar la precisión enfocándose en el contenido del documento.

Versión 3 (Recomendada)​

Endpoint​

Headers​

Parámetros​

Request​

Response​

Versión 2 (Deprecada)​

Endpoint​

Ejemplos de ID's​

Headers​

Parámetros​

Request​

Response​

Diferencias Clave Entre v2 y v3​

Beneficios de Migración​

Características​

Versión 3 (Recomendada)

Endpoint

Headers

Parámetros

Request

Response

Versión 2 (Deprecada)

Endpoint

Ejemplos de ID's

Headers

Parámetros

Request

Response

Diferencias Clave Entre v2 y v3

Beneficios de Migración

Características