Textify AutoParser API

Extract structured data from government ID documents using OCR and data extraction algorithms.

POST /v1/textify/parser

cURL

mexico-id

curl --request POST \
  --url https://textify-api.argosidentity.com/v1/textify/parser \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "country": "mex",
  "image": "base64-encoded-image-data"
}
'

200

{
  "rawExtractions": {
    "nombre": "LUIS DANIEL",
    "domicilio": "C CAMPO AEREO 24",
    "clave_de_elector": "SLGZL501094H42BH00",
    "fecha_de_nacimiento": "09/09/2001"
  },
  "standardized": {
    "country": "MEX",
    "person": {
      "name": {
        "givenName": "LUIS DANIEL",
        "paternalSurname": "GUZMAN",
        "fullName": "LUIS DANIEL GUZMAN"
      },
      "gender": "male",
      "dateOfBirth": "2001-09-09",
      "nationality": "MEX"
    },
    "document": {
      "type": "voter_id",
      "number": "SLGZL501094H42BH00",
      "issueDate": "2019-01-01",
      "expiryDate": "2030-12-31",
      "issuingAuthority": "INSTITUTO NACIONAL ELECTORAL"
    },
    "address": {
      "street": "C CAMPO AEREO 24",
      "city": "HUAJUAPAN DE LEON",
      "state": "OAX",
      "postalCode": "69007"
    }
  }
}

Textify ID AutoParser API es un servicio de extracción de texto de documentos que procesa documentos de identificación gubernamentales y extrae datos estructurados de imágenes. Soporta documentos de identificación utilizando cuatro plantillas diferentes. Primero, documentos de identificación con plantilla general; cualquier documento de identificación que no sea de los países del segundo tipo. El segundo tipo es de los siguientes países: México (MEX), Filipinas (PHL) y Corea del Sur (KOR).

---

​

Formatos de imagen soportados

✅ Soportados:

• JPEG (.jpg, .jpeg)
• PNG (.png)

❌ No soportados:

• GIF (.gif)
• BMP (.bmp)
• WebP (.webp)
• TIFF (.tiff, .tif)
• PDF (.pdf)

---

​

Tiempo de respuesta

⏱️ Tiempo de respuesta esperado: 20-30 segundos

La API procesa imágenes utilizando algoritmos avanzados de OCR y extracción de datos, que requieren un tiempo de procesamiento significativo. Planifique tiempos de espera de al menos 60 segundos en sus aplicaciones cliente.

---

​

Requisitos de imagen

​

Tamaño de archivo

• Recomendado: Menos de 10MB
• Máximo: 50MB

​

Calidad de imagen

• Resolución: Se recomienda un mínimo de 300 DPI
• Formato: Las imágenes de alto contraste y bien iluminadas funcionan mejor
• Orientación: El documento debe estar correctamente orientado (no rotado)

​

Codificación Base64

Las imágenes deben convertirse a formato Base64 antes de enviarlas. La cadena Base64 debe contener solo los datos de imagen codificados sin prefijos de URI de datos (por ejemplo, elimine data:image/jpeg;base64, si está presente).

---

​

Manejo de errores

​

Escenarios de error comunes

Status Code	Error Type	Descripción
400	Bad Request	El cuerpo de la solicitud debe contener un campo image con datos base64.
401	Unauthorized	Acceso denegado: la clave API no está disponible.
413	Payload Too Large	El archivo de imagen es demasiado grande
415	Unsupported Media Type	Formato de archivo no soportado. Solo se soportan archivos JPEG y PNG.
429	Too Many Requests	Se excedió el límite de solicitudes
500	Internal Server Error	Error del servidor OpenAI/Gemma API

---

Autorizaciones

x-api-key · string · header · requerido

Cuerpo

application/json

image · file · requerido

Base64 encoded image data. Only JPEG (.jpg, .jpeg) and PNG (.png) are supported.

country · enum<string>

Country code: "mex" (Mexico) or "phl" (Philippines) or "kor" (South Korea). Optional field that provides more concrete results when used.

Opciones disponibles: mex, phl, kor

Respuesta

200

application/json

Successful parsing

rawExtractions · object

Raw OCR results based on the fields depicted on the ID document. Output varies by document type and country.

standardized · object

Standardized data structure. Output format depends on country template used.

Show child attributes