ID Verification API

async function submitDocumentVerification(accessToken, frontImageFile, backImageFile = null, options = null) {
  const url = `https://verification.didit.me/v2/id-verification`;
 
  // Create a FormData instance
  const formData = new FormData();
  formData.append('front_image', frontImageFile);
 
  // Add back image if provided (required for dual-sided documents)
  if (backImageFile) {
    formData.append('back_image', backImageFile);
  }
 
  // Add options if provided
  if (options) {
    formData.append('options', JSON.stringify(options));
  }
 
  const requestOptions = {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${accessToken}`
    },
    body: formData
  };
 
  try {
    const response = await fetch(url, requestOptions);
 
    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(errorData.error?.message || errorData.detail || 'Unknown error occurred');
    }
 
    return await response.json();
  } catch (error) {
    console.error('Error in ID Verification:', error);
    throw error;
  }
}
 
// Example usage
async function performDocumentVerification(documentType) {
  try {
    // 1. Get client token (implement based on auth documentation)
    const token = await getClientToken();
 
    // 2. Get image files (from file input or other source)
    const frontImageFile = document.getElementById('front-image-input').files[0];
    let backImageFile = null;
 
    // Check if back image is required based on document type
    if (['id_card', 'driving_license'].includes(documentType)) {
      backImageFile = document.getElementById('back-image-input').files[0];
      if (!backImageFile) {
        throw new Error('Back image is required for ID cards and driving licenses');
      }
    }
 
    // 3. Custom options (optional)
    const options = {
      duplicated_user_action: "NO_ACTION",
      minimum_age: 18,
      expiration_date_not_detected_action: "NO_ACTION",
      invalid_code_action: "NO_ACTION",
      invalid_mrz_action: "DECLINE",
      documents_allowed: {
        "USA": {"p": 1, "id": 1, "dl": 1, "rp": 0},
        "GBR": {"p": 1, "id": 0, "dl": 1, "rp": 1}
      }
    };
 
    // 4. Submit document verification
    const result = await submitDocumentVerification(
      token.access_token,
      frontImageFile,
      backImageFile,
      options
    );
 
    console.log('ID Verification result:', result);
    console.log(`Document type: ${result.id_verification.document_type}`);
    console.log(`Full name: ${result.id_verification.full_name}`);
 
    return result;
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}

import requests
import json
 
def submit_document_verification(access_token, front_image_file, back_image_file=None, options=None):
    """
    Submit document images for ID verification.
 
    Args:
        access_token (str): The access token for authentication.
        front_image_file (file): Front side image of the identity document.
        back_image_file (file, optional): Back side image of the identity document.
        options (dict, optional): Customization options for document verification.
 
    Returns:
        dict: The ID verification results.
    """
    url = "https://verification.didit.me/v2/id-verification"
 
    headers = {
        "Authorization": f"Bearer {access_token}"
    }
 
    files = {
        "front_image": front_image_file
    }
 
    # Add back image if provided (required for dual-sided documents)
    if back_image_file:
        files["back_image"] = back_image_file
 
    # Add options if provided
    data = {}
    if options:
        data['options'] = json.dumps(options)
 
    try:
        response = requests.post(url, headers=headers, files=files, data=data)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error in ID Verification: {e}")
        if hasattr(e, 'response') and e.response:
            print(f"Response: {e.response.text}")
        raise
 
# Example usage
def perform_document_verification(document_type):
    try:
        # 1. Get client token (implement based on auth documentation)
        token = get_client_token()
 
        # 2. Get image files (from file input or other source)
        front_image_path = "document_front.jpg"
        back_image_path = None
 
        # Check if back image is required based on document type
        if document_type in ['id_card', 'driving_license']:
            back_image_path = "document_back.jpg"
 
        # 3. Custom options (optional)
        options = {
            "duplicated_user_action": "NO_ACTION",
            "minimum_age": 18,
            "expiration_date_not_detected_action": "NO_ACTION",
            "invalid_code_action": "NO_ACTION",
            "invalid_mrz_action": "DECLINE",
            "documents_allowed": {
                "USA": {"p": 1, "id": 1, "dl": 1, "rp": 0},
                "GBR": {"p": 1, "id": 0, "dl": 1, "rp": 1}
            }
        }
 
        # 4. Submit document verification
        with open(front_image_path, "rb") as front_img:
            back_img = None
            if back_image_path:
                back_img = open(back_image_path, "rb")
 
            try:
                result = submit_document_verification(
                    token["access_token"],
                    front_img,
                    back_img if back_image_path else None,
                    options
                )
            finally:
                if back_img:
                    back_img.close()
 
        print(f"ID Verification status: {result['kyc']['status']}")
        print(f"Document type: {result['kyc']['document_type']}")
        print(f"Full name: {result['kyc']['full_name']}")
 
        return result
    except Exception as e:
        print(f"Error: {e}")
        raise