PicToText LogoPicToText

Colombia ID Card

Extract data from Colombian ID Card (Cédula de Ciudadanía) with high accuracy using our advanced OCR technology.

Request Parameters

Required Parameters

Parameter Type Required Description
image File ✅ ID card image file (JPG, PNG, WebP, HEIC and HEIF, max 10MB)
documentType String ✅ Must be co_id_card

Response Format

Success Response (200 OK)

{
  "cardNumber": "1234567890",
  "dateOfBirth": "1990-01-01",
  "dateOfExpiry": "2030-01-01",
  "bloodType": "O+",
  "dateOfIssue": "2020-01-01",
  "gender": "Male",
  "height": "175",
  "placeOfBirth": "BOGOTA",
  "placeOfIssue": "BOGOTA",
  "givenNames": "JUAN CARLOS",
  "surname": "RODRIGUEZ"
}

Response Fields

Field Type Description Example
cardNumber string ID card number 1234567890
dateOfBirth string Date of birth (YYYY-MM-DD) 1990-01-01
dateOfExpiry string Expiry date (YYYY-MM-DD) 2030-01-01
bloodType string Blood type O+
dateOfIssue string Issue date (YYYY-MM-DD) 2020-01-01
gender string Gender Male
height string Height in cm 175
placeOfBirth string Place of birth BOGOTA
placeOfIssue string Place of issue BOGOTA
givenNames string Given names JUAN CARLOS
surname string Surname RODRIGUEZ

Code Examples

cURL

curl -X POST "https://pictotext.io/api/v1/ocr" \\
  -H "Authorization: Bearer sk_live_123456789abcdef" \\
  -F "image=@colombia_id.jpg" \\
  -F "documentType=co_id_card"

JavaScript (Browser)

async function processColombiaIDCard(imageFile, apiKey) {
  const formData = new FormData();
  formData.append('image', imageFile);
  formData.append('documentType', 'co_id_card');

  try {
    const response = await fetch('https://pictotext.io/api/v1/ocr', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${apiKey}`
      },
      body: formData
    });

    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.error.message);
    }

    return await response.json();
  } catch (error) {
    console.error('Error processing Colombia ID card:', error);
    throw error;
  }
}

// Usage example
const fileInput = document.getElementById('colombia-id-file');
fileInput.addEventListener('change', async (event) => {
  const file = event.target.files[0];
  if (file) {
    try {
      const result = await processColombiaIDCard(file, 'YOUR_API_KEY');
      console.log('Extracted data:', result);
    } catch (error) {
      alert('Processing failed: ' + error.message);
    }
  }
});

Python

import requests
import os

def extract_colombia_id_data(image_path, api_key):
    """Extract data from Colombia ID card image"""

    url = 'https://pictotext.io/api/v1/ocr'
    headers = {'Authorization': f'Bearer {api_key}'}

    try:
        with open(image_path, 'rb') as f:
            files = {
                'image': (os.path.basename(image_path), f, 'image/jpeg')
            }
            data = {'documentType': 'co_id_card'}

            response = requests.post(url, headers=headers, files=files, data=data, timeout=30)
            response.raise_for_status()

            return response.json()

    except requests.exceptions.RequestException as e:
        print(f"Request failed: {e}")
        if hasattr(e, 'response') and e.response is not None:
            print(f"Status code: {e.response.status_code}")
            print(f"Error response: {e.response.text}")
        return None

# Usage
result = extract_colombia_id_data('colombia_id.jpg', 'YOUR_API_KEY')
if result:
    print("Card Number:", result['cardNumber'])
    print("Name:", result['givenNames'], result['surname'])
    print("Full response:", result)
else:
    print("Failed to extract Colombia ID data")

Node.js

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

async function processColombiaIDCard(imagePath, apiKey) {
  const formData = new FormData();
  formData.append('image', fs.createReadStream(imagePath));
  formData.append('documentType', 'co_id_card');

  try {
    const response = await axios.post('https://pictotext.io/api/v1/ocr', formData, {
      headers: {
        ...formData.getHeaders(),
        'Authorization': `Bearer ${apiKey}`
      }
    });

    return response.data;
  } catch (error) {
    if (error.response) {
      console.error('API Error:', error.response.data);
    }
    throw error;
  }
}

// Usage
processColombiaIDCard('./colombia_id.jpg', 'YOUR_API_KEY')
  .then(result => console.log(result))
  .catch(error => console.error('Error:', error.message));

Related Documentation