POST
/
v1
/
textify
/
parser
curl --request POST \
  --url https://textify-api.kr.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"
    }
  }
}
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 CodeError TypeDescription
400Bad RequestRequest body must contain an image field with base64 data.
401UnauthorizedAccess Denied: API Key is unavailable.
413Payload Too LargeImage file too large
415Unsupported Media TypeUnsupported file format. Only JPEG and PNG files are supported.
429Too Many RequestsRate limit exceeded
500Internal Server ErrorOpenAI/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.