Philippines TinID

Extract data from Philippines TinID (Tax Identification Number ID) with high accuracy using our advanced OCR technology.

Request Parameters

Required Parameters

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

Response Format

Success Response (200 OK)

{
  "fullName": "JUAN M. DELA CRUZ",
  "licenseNumber": "123-456-789-000",
  "birthday": "1990-01-01",
  "issueDate": "2020-01-01",
  "address": "123 MAIN STREET, QUEZON CITY"
}

Response Fields

Field Type Description Example
fullName string Full name JUAN M. DELA CRUZ
licenseNumber string TIN number 123-456-789-000
birthday string Date of birth (YYYY-MM-DD) 1990-01-01
issueDate string Issue date (YYYY-MM-DD) 2020-01-01
address string Registered address 123 MAIN STREET, QUEZON CITY

Code Examples

cURL

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

JavaScript (Browser)

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

  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 Philippines TinID:', error);
    throw error;
  }
}

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

Python

import requests
import os

def extract_ph_tinid_data(image_path, api_key):
    """Extract data from Philippines TinID 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': 'ph_tinid'}

            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_ph_tinid_data('ph_tinid.jpg', 'YOUR_API_KEY')
if result:
    print("TIN Number:", result['licenseNumber'])
    print("Name:", result['fullName'])
    print("Full response:", result)
else:
    print("Failed to extract Philippines TinID data")

Node.js

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

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

  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
processPHTinID('./ph_tinid.jpg', 'YOUR_API_KEY')
  .then(result => console.log(result))
  .catch(error => console.error('Error:', error.message));

Related Documentation