# Verifications

A borrower verification session represents the
question and response flow for an agent to verify the identity of a human
who purports to be a particular borrower. For instance, upon receiving a phone
call, an agent would initiate a borrower verification, ask the questions to the
borrower, and enter their responses. A set of responses are either correct (thus
verifying the human as the borrower) or they are incorrect.

The agent is never shown the correct answers, so privacy risks are
minimized and socially engineered security attacks are mitigated.


## Get verifications

 - [GET /people/{personId}/verifications](https://docs.peachfinance.com/api-docs/api-public/verifications/peach.people.borrower_verification.handlers.borrower_verification_get_all.md): Retrieve all verifications—optionally filtering. Note that unlike most Peach "get all" endpoints,
the verifications get all endpoint returns items in a reverse chronological list, since almost
all interesting verifications are those which happened in the recent past.

## Start verification

 - [POST /people/{personId}/verifications](https://docs.peachfinance.com/api-docs/api-public/verifications/peach.people.borrower_verification.handlers.borrower_verification_create.md): Start a borrower verification session. Newly created verifications
include randomly selected questions about the borrower. The human must attempt
to provide correct answers to these questions in order for the borrower verification
to be successful.

To check if a verification can be started now without actually starting a verification,
add the query parameter dryRun=true to the URL. If a verification could be started now
return successful (204), otherwise return an error response with
nextVerificationOkAt indicating when the next verification can start.

## Get verification by ID

 - [GET /people/{personId}/verifications/{verificationId}](https://docs.peachfinance.com/api-docs/api-public/verifications/peach.people.borrower_verification.handlers.borrower_verification_get.md)

## Answer verification questions

 - [POST /people/{personId}/verifications/{verificationId}/attempts](https://docs.peachfinance.com/api-docs/api-public/verifications/peach.people.borrower_verification.handlers.borrower_verification_answer_attempt_create.md)