IncomeCertification

We currently support uploading only a single IncomeCertification at a time. If multiple IncomeCertifications are uploaded over subsequent requests, we will only use the most recent IncomeCertification for Assessment operations and Borrower responses.

We want to support a future use case where multiple IncomeCertifications may be uploaded and a subset of those documents chosen by a Borrower as the documentation to submit with their IDR Enrollment Request. To avoid changes to the API in the future, this is why a Borrower response provides the income_certifications property as an array.

🚧
Use IncomeCertificationPayload for API POST, PUT, and PATCH requests
When creating and updating a Borrower with supporting Income Certification document(s), you must use an IncomeCertificationPayload as your payload in the singular income_certification property of a BorrowerPayload payload.
When a Borrower is returned by the API, the Borrower object will hold a plural income_certifications property with IncomeCertification(s) within.

Schema Definition

Property	Type	Format	Description
`id`	`integer`	`int64`	The ID value of the `IncomeCertification` file uploaded for a `Borrower`.
`inserted_at`	`string`	`date-time`	A `DateTime` string that indicates when the `IncomeCertification` was first uploaded to our API.
`type`	`string`	`pay_stub` `tax_return` `determination_summary`	The type of supporting income/unemployment documentation uploaded for Enrollment or recertification.

Example

{
  "id": 198,
  "inserted_at": "2021-02-18 21:33:29",
  "type": "tax_return"
}