Applies to integrated customers using the RecoveryConnect APIBorrower Operations
The Borrower Operations section contains endpoints used to retrieve and update borrower information associated with an order. Borrower records include details such as borrower identity, contact information, and addresses related to the order.
All requests must include a valid Bearer token in the request header.
Retrieve Order Borrowers
Description: This endpoint retrieves the list of borrowers associated with a specific order.
Borrowers represent the individuals or entities responsible for the loan linked to the collateral in order. Each borrower record may include personal details, borrower role (borrower or co-borrower), contact information, and other related metadata.
This endpoint allows integrators to view all borrower records associated with a particular order.
URL: /api/v140/orders/{order_id}/borrowers
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57062885/borrowers |
Request Body: NA
Response:
{ "data": [ { "id": 124927241, "parent_id": 124927240, "order_id": 57062885, "person_id": 136781282, "role": "borrower", "is_violent": 0, "is_primary": 1, "active_military": 0, "is_deceased": 0, "is_fraud": 0, "created_at": "2026-02-17 10:45:03", "updated_at": "2026-02-17 10:45:03", "deleted_at": null, "bankruptcy": null, "firstname": "A_Toney", "middle_initial": "", "lastname": "Spencer", "birthday": null, "license_no": null, "license_state": null, "validated": 1, "migration": null, "phones": [], "ssn": null }, { "id": 124941995, "parent_id": 124941997, "order_id": 57062885, "person_id": 136786891, "role": "borrower", "is_violent": 0, "is_primary": 0, "active_military": 0, "is_deceased": 0, "is_fraud": 0, "created_at": "2026-03-07 13:20:43", "updated_at": "2026-03-07 13:20:44", "deleted_at": null, "bankruptcy": null, "firstname": "test", "middle_initial": "", "lastname": "borrower", "birthday": null, "license_no": "", "license_state": "", "validated": 1, "migration": null, "phones": [], "ssn": null } ] } |
Retrieve Order Borrower
Description: This endpoint retrieves the details of a specific borrower associated with an order.
Borrowers represent the individuals responsible for the loan tied to the collateral in order. By providing the order ID and borrower ID, this endpoint returns the detailed information related to that borrower.
URL: /api/v140/orders/{order_id}/borrowers/{borrower_id}
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57062885/borrowers/124927241 |
Request Body: NA
Response:
{ "data": { "id": 124927241, "parent_id": 124927240, "order_id": 57062885, "person_id": 136781282, "role": "borrower", "is_violent": 0, "is_primary": 1, "active_military": 0, "is_deceased": 0, "is_fraud": 0, "created_at": "2026-02-17 10:45:03", "updated_at": "2026-02-17 10:45:03", "deleted_at": null, "bankruptcy": null, "firstname": "A_Toney", "middle_initial": "", "lastname": "Spencer", "birthday": null, "license_no": null, "license_state": null, "validated": 1, "migration": null, "phones": [], "ssn": null } } |
Update Borrower
Description: This endpoint updates the details of a borrower associated with a specific order.
Only the fields provided in the request body will be updated. Fields not included in the request will remain unchanged.
URL: /api/v140/orders/{order_id}/borrowers/{borrower_id}
Method: PUT
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
role | Role of the person in the order (borrower or co-signer) | No | borrower |
is_primary | Indicates whether the borrower is the primary borrower (1 = Primary, 0 = Not Primary) | No | 1 |
active_military | Indicates if the borrower is currently serving in the military (0 = No, 1 = Yes) | No | 0 |
firstname | Borrower’s first name | No | vinay |
middle_initial | Borrower’s middle initial | No | test |
lastname | Borrower’s last name | No | ing |
birthday | Date of birth of the borrower | No | 2001-10-01 |
license_no | Driver’s license number of the borrower | No | D1234567 |
license_state | State where the driver’s license was issued | No | OH |
ssn | Social Security Number of the borrower | No | 123456789 |
is_fraud | Indicates whether the borrower is marked as fraud (0 = No, 1 = Yes) | No | 1 |
is_deceased | Indicates whether the borrower is deceased (0 = No, 1 = Yes) | No | 0 |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57062885/borrowers/124927241 |
Request Body:
{ "role": "borrower", "is_primary": 1, "active_military": 0, "firstname": "vinay", "middle_initial": "test", "lastname": "ing", "birthday": "2001-10-01", "license_no": null, "license_state": "OH", "ssn": 435267891, "is_fraud": 1, "is_deceased": 0 } |
Response:
{ "data": { "id": 124927241, "parent_id": 124927240, "order_id": 57062885, "person_id": 136781282, "role": "borrower", "is_violent": 0, "is_primary": 1, "active_military": 0, "is_deceased": 0, "is_fraud": 1, "created_at": "2026-02-17 10:45:03", "updated_at": "2026-03-07 13:29:34", "deleted_at": null, "bankruptcy": null, "firstname": "vinay", "middle_initial": "test", "lastname": "ing", "birthday": "2001-10-01", "license_no": null, "license_state": "OH", "validated": 1, "migration": null, "phones": [], "ssn": "XXXX67891" }, "status": "success", "warnings": [] } |