Configure income entity

This API allows you to update the employment start date for a borrower–employer pair linked to a specific Ocrolus Book. You can optionally include identifiers such as the employer’s EIN (Employer Identification Number) and the borrower’s last four SSN digits (Social Security Number) for more accurate matching. If the borrower–employer pair exists, the record is updated; otherwise, a new one is created. When provided, the employment start date is also used in income calculation to ensure the precise and consistent results across the platform.

📘

Note

• If the borrower–employer pair already exists, the system updates the existing record with the new start date.
• If the pair does not exist, a new configuration entry is created automatically.
• Optional identifiers (ein, last_four_ssn_digits, and income_type) help ensure accurate borrower–employer matching.