> ## 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 is a document text extraction service that processes government ID documents and extracts structured data from images.
It supports ID documents by using four different templates.
First, ID documents with general template; any ID documents that are not from countries from the second type.
The second type is from following countries; Mexico (MEX), Philippines (PHL), and South Korea (KOR).

***

## Supported Image Formats

✅ **Supported:**

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

❌ **Not Supported:**

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

***

## Response Time

⏱️ **Expected Response Time:** 20-30 seconds

The API processes images using advanced OCR and data extraction algorithms, which require significant processing time. Plan for timeouts of at least 60 seconds in your client applications.

***

## Image Requirements

### File Size

* **Recommended:** Less than 10MB
* **Maximum:** 50MB

### Image Quality

* **Resolution:** Minimum 300 DPI recommended
* **Format:** High contrast, well-lit images work best
* **Orientation:** Document should be properly oriented (not rotated)

### Base64 Encoding

Images must be converted to Base64 format before sending. The Base64 string should contain only the encoded image data without any data URI prefixes (e.g., remove `data:image/jpeg;base64,` if present).

***

## Error Handling

### Common Error Scenarios

| Status Code | Error Type             | Description                                                     |
| ----------- | ---------------------- | --------------------------------------------------------------- |
| 400         | Bad Request            | Request body must contain an image field with base64 data.      |
| 401         | Unauthorized           | Access Denied: API Key is unavailable.                          |
| 413         | Payload Too Large      | Image file too large                                            |
| 415         | Unsupported Media Type | Unsupported file format. Only JPEG and PNG files are supported. |
| 429         | Too Many Requests      | Rate limit exceeded                                             |
| 500         | Internal Server Error  | OpenAI/Gemma API Server Error                                   |

***


## 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

````