> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Textify AutoParser API

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

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                                      |

***


## OpenAPI

````yaml POST /v1/textify/parser
openapi: 3.1.0
info:
  title: Textify API
  description: >-
    The Textify API section enables users to analyze files based on their
    extension and document type. By providing the base64 encoded data of the
    file to be analyzed, users can retrieve valuable insights and information.
  version: 1.0.0
servers:
  - url: https://textify-api.argosidentity.com
    description: Production server
security: []
paths:
  /v1/textify/parser:
    post:
      summary: Parse ID Document
      description: >-
        Extract structured data from government ID documents using OCR and data
        extraction algorithms.
      operationId: parseIdDocument
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - image
              properties:
                country:
                  type: string
                  description: >-
                    Country code: "mex" (Mexico) or "phl" (Philippines) or "kor"
                    (South Korea). Optional field that provides more concrete
                    results when used.
                  enum:
                    - mex
                    - phl
                    - kor
                image:
                  type: string
                  description: >-
                    Base64 encoded image data. Only JPEG (.jpg, .jpeg) and PNG
                    (.png) are supported.
                  format: base64
            examples:
              mexico-id:
                summary: Mexico ID Example
                value:
                  country: mex
                  image: base64-encoded-image-data
              general-id:
                summary: General ID Example
                value:
                  image: base64-encoded-image-data
      responses:
        '200':
          description: Successful parsing
          content:
            application/json:
              schema:
                type: object
                properties:
                  rawExtractions:
                    type: object
                    description: >-
                      Raw OCR results based on the fields depicted on the ID
                      document. Output varies by document type and country.
                  standardized:
                    type: object
                    description: >-
                      Standardized data structure. Output format depends on
                      country template used.
                    properties:
                      country:
                        type: string
                        description: Detected country code
                      person:
                        type: object
                        description: Person information
                        properties:
                          name:
                            type: object
                            properties:
                              givenName:
                                type: string
                              paternalSurname:
                                type: string
                              maternalSurname:
                                type: string
                              fullName:
                                type: string
                          gender:
                            type: string
                          dateOfBirth:
                            type: string
                            format: date
                          nationality:
                            type: string
                      document:
                        type: object
                        description: Document information
                        properties:
                          type:
                            type: string
                          number:
                            type: string
                          issueDate:
                            type: string
                            format: date
                          expiryDate:
                            type: string
                            format: date
                          issuingAuthority:
                            type: string
                      address:
                        type: object
                        description: Address information
                        properties:
                          street:
                            type: string
                          city:
                            type: string
                          state:
                            type: string
                          postalCode:
                            type: string
              examples:
                mexico-response:
                  summary: Mexico ID Response
                  value:
                    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'
        '400':
          description: >-
            Bad request - Request body must contain an image field with base64
            data
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Request body must contain an image field with base64 data.
        '401':
          description: Unauthorized - API Key is unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: 'Access Denied: API Key is unavailable.'
        '413':
          description: Payload Too Large - Image file too large
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Image file too large
        '415':
          description: Unsupported Media Type - Only JPEG and PNG files are supported
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Unsupported file format. Only JPEG and PNG files are
                      supported.
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Rate limit exceeded
        '500':
          description: Internal Server Error - OpenAI/Gemma API Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: OpenAI/Gemma API Server Error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````