Proof of Address Verification API

async function submitPoaVerification(accessToken, documentFile, options = null) {
  const url = `https://verification.didit.me/v2/poa/`;
 
  // Create a FormData instance
  const formData = new FormData();
  formData.append('document', documentFile);
 
  // 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 POA Verification:', error);
    throw error;
  }
}
 
// Example usage
async function performPoaVerification() {
  try {
    // 1. Get client token (implement based on auth documentation)
    const token = await getClientToken();
 
    // 2. Get document file (from file input or other source)
    const documentFile = document.getElementById('poa-document-input').files[0];
 
    if (!documentFile) {
      throw new Error('Please select a document file');
    }
 
    // 3. Custom options (optional)
    const options = {
      "poa_languages_allowed": {
        "en": true,
        "es": true,
        "fr": true
      },
      "poa_document_age_months": {
        "utility_bill": 3,
        "bank_statement": 3
      },
      "poa_name_mismatch_action": "DECLINE",
      "poa_document_issues_action": "DECLINE",
      "poa_expired_document_action": "DECLINE",
      "poa_unsupported_language_action": "DECLINE",
      "poa_address_mismatch_action": "DECLINE",
      "poa_issuer_not_identified_action": "DECLINE",
      "poa_issue_date_not_detected_action": "DECLINE"
    };
 
    // 4. Submit POA verification
    const result = await submitPoaVerification(
      token.access_token,
      documentFile,
      options
    );
 
    console.log('POA Verification result:', result);
    console.log(`Document type: ${result.poa.document_type}`);
    console.log(`Address: ${result.poa.formatted_address}`);
 
    return result;
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}

import requests
import json
 
def submit_poa_verification(access_token, document_file, options=None):
    """
    Submit document for proof of address verification.
 
    Args:
        access_token (str): The access token for authentication.
        document_file (file): The proof of address document file.
        options (dict, optional): Customization options for POA verification.
 
    Returns:
        dict: The POA verification results.
    """
    url = "https://verification.didit.me/v2/poa/"
 
    headers = {
        "Authorization": f"Bearer {access_token}"
    }
 
    files = {
        "document": document_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 POA Verification: {e}")
        if hasattr(e, 'response') and e.response:
            print(f"Response: {e.response.text}")
        raise
 
# Example usage
def perform_poa_verification():
    try:
        # 1. Get client token (implement based on auth documentation)
        token = get_client_token()
 
        # 2. Get document file path
        document_path = "utility_bill.pdf"
 
        # 3. Custom options (optional)
        options = {
            "poa_languages_allowed": {
                "en": True,
                "es": True,
                "fr": True
            },
            "poa_document_age_months": {
                "utility_bill": 3,
                "bank_statement": 3
            },
            "poa_name_mismatch_action": "DECLINE",
            "poa_document_issues_action": "DECLINE",
            "poa_expired_document_action": "DECLINE",
            "poa_unsupported_language_action": "DECLINE",
            "poa_address_mismatch_action": "DECLINE",
            "poa_issuer_not_identified_action": "DECLINE",
            "poa_issue_date_not_detected_action": "DECLINE"
        }
 
        # 4. Submit POA verification
        with open(document_path, "rb") as doc_file:
            result = submit_poa_verification(
                token["access_token"],
                doc_file,
                options
            )
 
        print(f"POA Verification status: {result['poa']['status']}")
        print(f"Document type: {result['poa']['document_type']}")
        print(f"Address: {result['poa']['formatted_address']}")
 
        return result
    except Exception as e:
        print(f"Error: {e}")
        raise