The Borrower object represents a borrower. It allows you to maintain different statuses that are associated with the same borrower. The API allows you to create, delete and update your borrowers. You can retrieve an individual borrower as well as a list of all your borrowers.
Create a new borrower.
Represents various users such as a borrower, co-borrower, co-signer, etc. A lender can choose to provide PII or not. If no PII is provided, Peach cannot monitor for bankruptcy, deceased and SCRA.
Success
{- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "collectionsIntensity": "light",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "name": {
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string"
}, - "dateOfBirth": "2019-08-24",
- "identity": {
- "identityType": "SSN",
- "customIdentityTypeName": "string",
- "value": "string",
- "valid": true,
- "issueDate": "2019-08-24",
- "expirationDate": "2019-08-24",
- "issuingCountry": ""
}
}
{- "status": 0,
- "message": "string",
- "data": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "statusUpdatedAt": "2019-08-24T14:15:22Z",
- "collectionsIntensity": "light",
- "displayId": "string",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "user": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "companyId": "string",
- "externalId": "string",
- "status": "active",
- "type": "borrower",
- "roleIds": [
- "string"
], - "object": "user",
- "userId": 0,
- "userName": "string",
- "auths": [
- {
- "authType": "basic",
- "authValueType": "email",
- "value": "string"
}
]
}, - "object": "person",
- "name": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "name",
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string",
- "current": true,
- "status": "active",
- "effectiveAt": "2019-08-24T14:15:22Z",
- "originalValue": { },
- "source": "peach"
}, - "dateOfBirth": "2019-08-24",
- "identities": [
- {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "identity",
- "identityType": "SSN",
- "customIdentityTypeName": "string",
- "value": "string",
- "valid": true,
- "issueDate": "2019-08-24",
- "expirationDate": "2019-08-24",
- "issuingCountry": "",
- "isArchived": true,
- "isPrimary": false
}
]
}
}
Get borrowers filtering with optional parameters.
Success
{- "status": 0,
- "total": 0,
- "count": 0,
- "nextUrl": "string",
- "previousUrl": "string",
- "data": [
- {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "statusUpdatedAt": "2019-08-24T14:15:22Z",
- "collectionsIntensity": "light",
- "displayId": "string",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "user": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "companyId": "string",
- "externalId": "string",
- "status": "active",
- "type": "borrower",
- "roleIds": [
- "string"
], - "object": "user",
- "userId": 0,
- "userName": "string",
- "auths": [
- {
- "authType": "basic",
- "authValueType": "email",
- "value": "string"
}
]
}, - "object": "person",
- "name": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "name",
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string",
- "current": true,
- "status": "active",
- "effectiveAt": "2019-08-24T14:15:22Z",
- "originalValue": { },
- "source": "peach"
}, - "dateOfBirth": "2019-08-24",
- "identities": [
- {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "identity",
- "identityType": "SSN",
- "customIdentityTypeName": "string",
- "value": "string",
- "valid": true,
- "issueDate": "2019-08-24",
- "expirationDate": "2019-08-24",
- "issuingCountry": "",
- "isArchived": true,
- "isPrimary": false
}
]
}
]
}
Search for borrowers. Returns same resources
as /people
.
Success
{- "data": [
- {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "statusUpdatedAt": "2019-08-24T14:15:22Z",
- "collectionsIntensity": "light",
- "displayId": "string",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "user": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "companyId": "string",
- "externalId": "string",
- "status": "active",
- "type": "borrower",
- "roleIds": [
- "string"
], - "object": "user",
- "userId": 0,
- "userName": "string",
- "auths": [
- {
- "authType": "basic",
- "authValueType": "email",
- "value": "string"
}
]
}, - "object": "person",
- "name": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "name",
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string",
- "current": true,
- "status": "active",
- "effectiveAt": "2019-08-24T14:15:22Z",
- "originalValue": { },
- "source": "peach"
}, - "dateOfBirth": "2019-08-24",
- "identities": [
- {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "identity",
- "identityType": "SSN",
- "customIdentityTypeName": "string",
- "value": "string",
- "valid": true,
- "issueDate": "2019-08-24",
- "expirationDate": "2019-08-24",
- "issuingCountry": "",
- "isArchived": true,
- "isPrimary": false
}
]
}
], - "search": {
- "maxScore": 0,
- "scores": { }
}
}
Get an existing borrower by ID.
Success
{- "status": 0,
- "message": "string",
- "data": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "statusUpdatedAt": "2019-08-24T14:15:22Z",
- "collectionsIntensity": "light",
- "displayId": "string",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "user": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "companyId": "string",
- "externalId": "string",
- "status": "active",
- "type": "borrower",
- "roleIds": [
- "string"
], - "object": "user",
- "userId": 0,
- "userName": "string",
- "auths": [
- {
- "authType": "basic",
- "authValueType": "email",
- "value": "string"
}
]
}, - "object": "person",
- "name": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "name",
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string",
- "current": true,
- "status": "active",
- "effectiveAt": "2019-08-24T14:15:22Z",
- "originalValue": { },
- "source": "peach"
}, - "dateOfBirth": "2019-08-24",
- "identities": [
- {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "identity",
- "identityType": "SSN",
- "customIdentityTypeName": "string",
- "value": "string",
- "valid": true,
- "issueDate": "2019-08-24",
- "expirationDate": "2019-08-24",
- "issuingCountry": "",
- "isArchived": true,
- "isPrimary": false
}
]
}
}
Update an existing borrower.
Represents various users such as a borrower, co-borrower, co-signer, etc. A lender can choose to provide PII or not. If no PII is provided, Peach cannot monitor for bankruptcy, deceased and SCRA.
Success
{- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "collectionsIntensity": "light",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "name": {
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string"
}, - "dateOfBirth": "2019-08-24",
- "caseId": "string"
}
{- "status": 0,
- "message": "string",
- "data": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "borrowerType": "person",
- "externalId": "string",
- "status": "active",
- "statusUpdatedAt": "2019-08-24T14:15:22Z",
- "collectionsIntensity": "light",
- "displayId": "string",
- "metaData": { },
- "commPreferences": {
- "statementDeliveryChannels": [
- "email"
], - "sendRemindersWhenCurrent": true
}, - "monitorStartDate": "2019-08-24",
- "companyId": "string",
- "user": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "companyId": "string",
- "externalId": "string",
- "status": "active",
- "type": "borrower",
- "roleIds": [
- "string"
], - "object": "user",
- "userId": 0,
- "userName": "string",
- "auths": [
- {
- "authType": "basic",
- "authValueType": "email",
- "value": "string"
}
]
}, - "object": "person",
- "name": {
- "id": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": "2019-08-24T14:15:22Z",
- "object": "name",
- "prefix": "string",
- "firstName": "string",
- "middleName": "string",
- "lastName": "string",
- "maidenLastName": "string",
- "suffix": "strin",
- "preferredFirstName": "string",
- "current": true,
- "status": "active",
- "effectiveAt": "2019-08-24T14:15:22Z",
- "originalValue": { },
- "source": "peach"
}, - "dateOfBirth": "2019-08-24"
}
}