Applies to integrated customers using the RecoveryConnect API
Attach Recovery Condition Report PDF
Description: This endpoint uploads and attaches a Recovery Condition Report document (PDF) to a specific recovery record associated with an order.
The document must be provided as a Base64 encoded string along with metadata such as the file name and document name. This report is typically used to document the condition of the recovered collateral, including details such as vehicle status, damages, mileage, and other recovery-related information.
URL: /api/v130/orders/{order_id}/recoveries/{recovery_id}/documents
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE | |
file_name | Name of the uploaded document including file extension | Yes | test.pdf | |
document_name | Display name or label used to identify the document | Yes |
instruction-document | |
data | Base64 encoded string representing the PDF document content | Yes | dGhpcyBpcyBzYW1wbGUgcGRm…. | |
type | Identifier representing the document type (refer to Order Attachment Type IDs reference table) | No | 2 |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v130/orders/57070277/recoveries/10120166/documents |
Request Body:
{ "file_name": "test.pdf", "document_name": "instruction-document", "data": "CiVQREYtMS43CiXDpMO8w7bDnwoyIDAgb2JqCjw……” } |
Response:
{ "data": { "order_id": "57070277", "type": 2, "attachment_id": 180461045, "recovery_id": "10120166", "case_attachment_type_id": 17, "id": 182214553 }, "status": "success" } |
8.3 Update Recovery
Description: This endpoint updates the details of an existing recovery associated with an order.
Recoveries represent events where collateral linked to an order has been recovered or repossessed. This endpoint allows users to modify recovery-related information such as recovery details, vehicle condition, police notification details, and other recovery metadata.
Only the fields included in the request body will be updated. Fields not provided will remain unchanged.
URL: /api/v130/orders/{order_id}/recoveries/{recovery_id}
Method: PUT
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE | |
recovery_date | Date when the recovery occurred | No | 2026-03-01 10:48:00
| |
recovery_police_notified_date | Date when the police agency was notified | No | 2026-03-01 10:48:00
| |
color | Color ID of the vehicle | No | yellow | |
driveable | Indicates whether the vehicle was driveable at recovery | No | 2 | |
miles | Odometer reading of the vehicle at the time of recovery.
| No | 56822
|
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v130/orders/57070277/recoveries/10120166 |
Request Body:
{
"recovery_date": "2026-03-10 10:48:00", "recovery_police_notified_date": "2026-03-09 10:48:00", "color_id":"yellow", "drivable": 2, "miles": 56811, "access_to_interior": 1
} |
Response:
{ "data": { "success": true, "recovery_id": 10120166, "is_condition_completed": true }, "status": "success" } |