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

Authorizations

x-api-key

string

header

required

Body

application/json

image

file

required

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.

Available options:

mex,

phl,

kor

Response

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

​Supported Image Formats

​Response Time

​Image Requirements

​File Size

​Image Quality

​Base64 Encoding

​Error Handling

​Common Error Scenarios