Textify AutoParser API - ARGOS Identity

POST

textify

parser

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"
}
'

{
  "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"
    }
  }
}

{
  "message": "Request body must contain an image field with base64 data."
}

{
  "message": "Access Denied: API Key is unavailable."
}

{
  "message": "Image file too large"
}

{
  "message": "Unsupported file format. Only JPEG and PNG files are supported."
}

{
  "message": "Rate limit exceeded"
}

{
  "message": "OpenAI/Gemma API Server Error"
}

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

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

⌘I

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"
}
'

{
  "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"
    }
  }
}

{
  "message": "Request body must contain an image field with base64 data."
}

{
  "message": "Access Denied: API Key is unavailable."
}

{
  "message": "Image file too large"
}

{
  "message": "Unsupported file format. Only JPEG and PNG files are supported."
}

{
  "message": "Rate limit exceeded"
}

{
  "message": "OpenAI/Gemma API Server Error"
}

​Formatos de imagen soportados

​Tiempo de respuesta

​Requisitos de imagen

​Tamaño de archivo

​Calidad de imagen

​Codificación Base64

​Manejo de errores

​Escenarios de error comunes