AML Screening API

async function submitAmlScreening(accessToken, fullName, dateOfBirth, nationality, documentNumber = null, options = null) {
  const url = `https://verification.didit.me/v2/aml/`;
 
  // Prepare request data
  const requestData = {
    full_name: fullName,
    date_of_birth: dateOfBirth,
    nationality: nationality
  };
 
  // Add optional document number if provided
  if (documentNumber) {
    requestData.document_number = documentNumber;
  }
 
  // Add options if provided
  if (options) {
    requestData.options = options;
  }
 
  const requestOptions = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${accessToken}`
    },
    body: JSON.stringify(requestData)
  };
 
  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 AML screening:', error);
    throw error;
  }
}
 
// Example usage
async function performAmlScreening() {
  try {
    // 1. Get client token (implement based on auth documentation)
    const token = await getClientToken();
 
    // 2. Custom options (optional)
    const options = {
      aml_score_approve_threshold: 75,
    };
 
    // 3. Submit AML screening
    const result = await submitAmlScreening(
      token.access_token,
      'John Michael Doe',
      '1985-05-15',
      'USA',
      'AB123456', // Optional document number
      options     // Optional customization options
    );
 
    console.log('AML screening result:', result);
 
    // Handle the screening result
    if (result.aml.status === 'Approved') {
      console.log('No significant AML risks detected.');
    } else if (result.aml.status === 'Declined') {
      console.log('High-risk AML matches detected.');
    }
 
    return result;
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}

import requests
from datetime import datetime
 
def submit_aml_screening(access_token, full_name, date_of_birth, nationality, document_number=None, options=None):
    """
    Submit AML screening for an individual.
 
    Args:
        access_token (str): The access token for authentication.
        full_name (str): Full name of the person to screen.
        date_of_birth (str): Date of birth in YYYY-MM-DD format.
        nationality (str): Nationality in ISO 3166-1 alpha-3 format.
        document_number (str, optional): Document identification number.
        options (dict, optional): Customization options for AML screening.
 
    Returns:
        dict: The AML screening results.
    """
    url = "https://verification.didit.me/v2/aml/"
 
    # Validate date format
    try:
        # Ensure date is in YYYY-MM-DD format
        datetime.strptime(date_of_birth, '%Y-%m-%d')
    except ValueError:
        raise ValueError("Invalid date format. Date of birth must be in YYYY-MM-DD format")
 
    # Prepare request data
    request_data = {
        "full_name": full_name,
        "date_of_birth": date_of_birth,
        "nationality": nationality
    }
 
    # Add optional document number if provided
    if document_number:
        request_data["document_number"] = document_number
 
    # Add options if provided
    if options:
        request_data["options"] = options
 
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {access_token}"
    }
 
    try:
        response = requests.post(url, headers=headers, json=request_data)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error in AML screening: {e}")
        if hasattr(e, 'response') and e.response:
            print(f"Response: {e.response.text}")
        raise
 
# Example usage
def perform_aml_screening():
    try:
        # 1. Get client token (implement based on auth documentation)
        token = get_client_token()
 
        # 2. Custom options (optional)
        options = {
            "aml_score_approve_threshold": 75,
        }
 
        # 3. Submit AML screening
        result = submit_aml_screening(
            token["access_token"],
            "John Michael Doe",
            "1985-05-15",
            "USA",
            "AB123456",  # Optional document number
            options      # Optional customization options
        )
 
        print(f"AML screening status: {result['aml']['status']}")
        print(f"Total hits: {result['aml']['total_hits']}")
        print(f"Risk score: {result['aml']['score']}")
 
        # Handle the screening result
        if result['aml']['status'] == 'Approved':
            print("No significant AML risks detected.")
        elif result['aml']['status'] == 'Declined':
            print("High-risk AML matches detected.")
 
        return result
    except Exception as e:
        print(f"Error: {e}")
        raise