Configuration

{
    "id": "6797df82a4c4910bc0f1d490",
    "name": "EMPLOYMENT",
    "options": {
        "bank_statement_analysis": true,
        "require_pay_slips": true,
        "tax_return_verification": true,
        "employer_confirmation": true
    },
    "control_flow": {
        "condition": {
            "condition_operator": "==",
            "condition_field": "employment_status",
            "condition_value": "verified"
        },
        "if_goto": "6797dfb4a4c4910bc0f1d491",
        "else_goto": "6797fd5e683fb54e8abe7d852"
    },
    "provider": {
        "name": "Argyle"
    }
}

Config Fields

  • id: Unique identifier for the verification step
  • name: Step type identifier (EMPLOYMENT)
  • options: Configuration options for the verification process
    • bank_statement_analysis: Whether to analyze bank statements for income verification
    • require_pay_slips: Whether to require pay slip documentation
    • tax_return_verification: Whether to verify against tax returns
    • employer_confirmation: Whether to require direct employer confirmation
  • control_flow: Logic for the next step based on verification result
    • condition: Defines the decision criteria
      • condition_operator: Comparison operator (==)
      • condition_field: Field to evaluate (employment_status)
      • condition_value: Required verification status (verified)
    • if_goto: Next step if verification is successful
    • else_goto: Next step if verification fails
  • provider: The employment verification service provider configuration
    • name: Provider name (Argyle)

Example Response

{
    "status": "completed",
    "result": {
        "employment_status": "verified",
        "verification_id": "emp_ver_789012",
        "employer": {
            "name": "Tech Corporation Inc.",
            "employer_id": "emp_123456",
            "ein": "12-3456789",
            "address": {
                "street": "456 Corporate Plaza",
                "city": "San Francisco",
                "state": "CA",
                "postal_code": "94105",
                "country": "US"
            }
        },
        "employment_details": {
            "start_date": "2023-03-15",
            "employment_type": "full_time",
            "job_title": "Senior Software Engineer",
            "employment_status": "active",
            "last_payroll_date": "2025-02-01"
        },
        "verification_sources": {
            "payroll_provider": {
                "name": "ADP",
                "verified": true,
                "last_verified": "2025-02-03T11:45:06-05:00"
            },
            "bank_statements": {
                "verified": true,
                "analyzed_months": 3,
                "last_statement_date": "2025-01-31"
            },
            "pay_slips": {
                "verified": true,
                "documents": [
                    {
                        "document_id": "doc_123",
                        "pay_period": "2025-01-16 to 2025-01-31",
                        "verified": true
                    }
                ]
            },
            "tax_returns": {
                "verified": true,
                "tax_year": "2024",
                "document_id": "tax_789"
            },
            "employer_confirmation": {
                "verified": true,
                "confirmation_date": "2025-02-02",
                "confirmation_method": "phone"
            }
        },
        "income": {
            "base_salary": {
                "amount": 150000.00,
                "currency": "USD",
                "frequency": "yearly"
            },
            "year_to_date": {
                "gross_pay": 12500.00,
                "net_pay": 8750.00,
                "period_start": "2025-01-01",
                "period_end": "2025-02-01"
            },
            "recent_payments": [
                {
                    "pay_date": "2025-02-01",
                    "pay_period": {
                        "start_date": "2025-01-16",
                        "end_date": "2025-01-31"
                    },
                    "gross_amount": 6250.00,
                    "net_amount": 4375.00,
                    "earnings": {
                        "regular": 5769.23,
                        "overtime": 480.77
                    },
                    "deductions": {
                        "federal_tax": 1250.00,
                        "state_tax": 375.00,
                        "social_security": 187.50,
                        "medicare": 62.50
                    }
                }
            ]
        },
        "verification_metadata": {
            "provider": "Argyle",
            "verification_time": "2025-02-03T11:45:06-05:00",
            "verification_method": "multi_source",
            "data_refresh_date": "2025-02-03"
        }
    },
    "timestamp": "2025-02-03T11:45:06-05:00"
}

Output Fields

  • status: The completion status of the verification
  • result: The verification results containing:
    • employment_status: Whether the employment was successfully verified
    • verification_id: Unique identifier for this verification attempt
    • employer: Information about the employer
      • Company name and identifier
      • Employer Identification Number (EIN)
      • Address details
    • employment_details: Details about the employment
      • Start date and employment type
      • Job title and status
      • Last payroll date
    • verification_sources: Details of each verification method
      • Payroll provider verification
      • Bank statement analysis
      • Pay slip verification
      • Tax return verification
      • Employer confirmation
    • income: Detailed income information
      • Base salary and frequency
      • Year-to-date earnings
      • Recent payment details including:
        • Pay period information
        • Gross and net amounts
        • Earnings breakdown
        • Deduction details
    • verification_metadata: Information about the verification process
      • Provider used
      • Verification timestamp
      • Multi-source verification method
      • Last data refresh date
  • timestamp: Time when the verification was completed