Applies to integrated customers using the RecoveryConnect API
Create Recovery Personals Photos
Description: This endpoint uploads and attaches photos related to personal property recorded during a recovery.
When personal belongings are discovered in the recovered collateral (such as items in the trunk, glove compartment, or cabin), photos can be uploaded for documentation purposes. The image must be provided as a Base64 encoded string along with metadata such as the file name, image name, capture time, and attachment type.
URL: /api/v150/orders/{order_id}/recoveries/{recovery_id}/personals/photos
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE | |
file_name | Name of the uploaded image | Yes | test.pdf | |
image_name | Display name or label for the image | Yes |
instruction-document | |
picture_time | Date and time when the photo was taken | Yes | 2026-03-08 23:23:00 | |
data | Base64 encoded string representing the image | Yes | dGhpcyBpcyBzYW1wbGUgcGRm…. | |
type | Identifier representing the image type (refer to Order Attachment Type IDs reference table) | No | 2 |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57073414/recoveries/10120407/personals/photos |
Request Body:
{ "file_name": "name", "image_name": "New Picture", "picture_time": "2026-03-08 23:23:00", "data": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxIQDxAPEBAQAQ……………, } |
Response:
{ "data": { "order_id": "57073414", "type": 0, "case_attachment_type_id": 20, "recovery_has_damage_type_location_id": null, "attachment_id": 180461047, "recovery_id": 10120407 }, "status": "success" } |
Retrieve Recovery Photos
Description: This endpoint retrieves the list of photos associated with a specific recovery record.
Recovery photos are captured during the recovery process to document the condition of the collateral, including vehicle status, damages, surroundings, or other recovery-related evidence. This endpoint returns all photos uploaded for the specified recovery.
URL: /api/v150/orders/{order_id}/recoveries/{recovery_id}/photos
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57070277/recoveries/10120166/photos |
Request Body: NA
Response:
{ "data": [ { "id": 180461051, "type": { "id": 3, "name": "LF Fender", "always_show": 1, "is_required": 1, "type": "photos", "created_at": "2020-01-20 15:12:11", "updated_at": "2022-02-16 11:51:49", "deleted_at": null }, "order_attachment_type_id": 3, "recovery_has_damage_type_location_id": null, "order_id": 57070277, "name": "standard-l-f-fender", "photo_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/original/10004/424549/2026/03/11/q5jYd3eirPlT/images.jpeg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCAicqNV2%2FnhXV56JMQ97SSa6FVs%2F7JBUw5qPjT0%2FjuNwIhAOYpCYyP1MFH7y0N9waFnGyOs5dq8ne%2BVFMaBgRMgSAvKrkFCGIQAxoMOTU2MTMyMDIxMTg3IgzRCiWWxf6z8CBeZd4qlgXuf4u8M3rLPFHP2WrmJ%2BMV0ksqZh2VfSzj5ALyRwtEf61usjFMMN%2FLq4xONMGnlZoiSvLTkZ%2BcFe9Lu0ZCdYb%2BlxapMN4HbWPMafNyBic%2B%2FZhTDNfxdFs1DSfvj91eebqa7DjcJYdgz5k2tBQAr6esECwKBmlu%2FaBE1nV7Olr0k%2B45ylgMVklCGxM%2BefSmUPnUu9Zbh4x5SlkkSGY0IvX0Q%2FBdkYh1L6hPcjpGlwf64RbvqgLY3zO24G1zWq%2FWs7cF66%2FJi2wnjeKLPHLhOR7GjN4h3UAVc00Ukg7%2BbosACEyeM8doHm4g4skO4W9RTQNBt8MRpeSvtif7pTa0cVYRSRjBBqDCQoVqsLFFaFpKEYZAHJ7A8zMpombQ4s3MUfRgrWVZAMWoQWVCP2aVYVRT%2Fb36LvltEyLGZrB8iDh89W4BgL2%2BdwNYr3kly6R8J097yBvn3SlpwnRlHX0kTixg%2FfMsLsgHZsbE%2FJiFz0wNKfLS5Xm%2FFRLlBti35NZqESxTqu%2FNVN2fBE15o%2FsuvnQCAIq4J2iZ0u875Zk5GrkXgpr%2F07Q9TPvMWiMYeBrwvRzYpmWFAWO0v52L%2BPiHFlXJn8JbL7r9s%2B9QHE%2F0VqqawIpfJITFBbpAY7hJtCLo50f3a3zWoCnowM64quvmU8vjZBdFzd0yTV6W1oc3gpCVOWIS3GZOamyRUspu5lCD2BgjpPc9E7xs0YJoY5FHRS4ijYpppU9X%2BzZz3LPCHV0yDNvq3Nx1YISuyuAx6vy1CFqZMw14oINNZhx0AWqeO6yutGX7v6qI%2FCvkd3FtjWjzLuec8bkEMW4WmF%2BW2scutI%2FA83AclBbl1CgAqaFkZjtHNVMzOfSWg31tK6VfCyy6pgB%2BB8ZI%2FDDEwcbNBjqwAZcvWNKbpIWtHX3BpFxRGOHxvGhfEC07W4EuGnrwiTDMTXbH9wtoPzobbQJ0Aixadx79OzVMvrh5uD33t7wVYclyFKJDIVm3zqvZ%2BrHJaBC2sv0LpYuQlE45Y1ZOv0FODG5jKuS46YIk0uWLqxcok6Yc5nehvtl6iFlSX45%2FGgh2B0TucH8qxfAjj7bIqNM3m1A0gZ99wk%2FcefEJCvdwsgztl2m8BPhgIYhr2YtXHe%2Br&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PB3VZNHKQU%2F20260311%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260311T172236Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=58dff717272805ad97070312dee770d7714d546315946453bd6e73962975b09e", "filename": "images.jpeg", "uploaded_by": { "id": 424549, "company_id": 10004, "name": "Vinay Forwarder", "firstname": "Vinay", "lastname": "Forwarder", "contact": { "email": "vinay.band@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Compliance Officer FWD ", "Field Agent", "Accountant", "MBSiQ", "Transportation FWD" ], "self": "http://stg-api.mbsisystems.com/api/employees/424549", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 17:21:46", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-11 17:21:46", "created_at": "2026-03-11T17:21:46.000000Z" } }, { "id": 180461050, "type": { "id": 4, "name": "Front: Center", "always_show": 1, "is_required": 1, "type": "photos", "created_at": "2020-01-20 15:12:11", "updated_at": "2020-06-27 06:26:39", "deleted_at": null }, "order_attachment_type_id": 4, "recovery_has_damage_type_location_id": null, "order_id": 57070277, "name": "standard-front:-center", "photo_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/original/10004/424549/2026/03/11/TFgdb0VXBVaD/download.jpeg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCAicqNV2%2FnhXV56JMQ97SSa6FVs%2F7JBUw5qPjT0%2FjuNwIhAOYpCYyP1MFH7y0N9waFnGyOs5dq8ne%2BVFMaBgRMgSAvKrkFCGIQAxoMOTU2MTMyMDIxMTg3IgzRCiWWxf6z8CBeZd4qlgXuf4u8M3rLPFHP2WrmJ%2BMV0ksqZh2VfSzj5ALyRwtEf61usjFMMN%2FLq4xONMGnlZoiSvLTkZ%2BcFe9Lu0ZCdYb%2BlxapMN4HbWPMafNyBic%2B%2FZhTDNfxdFs1DSfvj91eebqa7DjcJYdgz5k2tBQAr6esECwKBmlu%2FaBE1nV7Olr0k%2B45ylgMVklCGxM%2BefSmUPnUu9Zbh4x5SlkkSGY0IvX0Q%2FBdkYh1L6hPcjpGlwf64RbvqgLY3zO24G1zWq%2FWs7cF66%2FJi2wnjeKLPHLhOR7GjN4h3UAVc00Ukg7%2BbosACEyeM8doHm4g4skO4W9RTQNBt8MRpeSvtif7pTa0cVYRSRjBBqDCQoVqsLFFaFpKEYZAHJ7A8zMpombQ4s3MUfRgrWVZAMWoQWVCP2aVYVRT%2Fb36LvltEyLGZrB8iDh89W4BgL2%2BdwNYr3kly6R8J097yBvn3SlpwnRlHX0kTixg%2FfMsLsgHZsbE%2FJiFz0wNKfLS5Xm%2FFRLlBti35NZqESxTqu%2FNVN2fBE15o%2FsuvnQCAIq4J2iZ0u875Zk5GrkXgpr%2F07Q9TPvMWiMYeBrwvRzYpmWFAWO0v52L%2BPiHFlXJn8JbL7r9s%2B9QHE%2F0VqqawIpfJITFBbpAY7hJtCLo50f3a3zWoCnowM64quvmU8vjZBdFzd0yTV6W1oc3gpCVOWIS3GZOamyRUspu5lCD2BgjpPc9E7xs0YJoY5FHRS4ijYpppU9X%2BzZz3LPCHV0yDNvq3Nx1YISuyuAx6vy1CFqZMw14oINNZhx0AWqeO6yutGX7v6qI%2FCvkd3FtjWjzLuec8bkEMW4WmF%2BW2scutI%2FA83AclBbl1CgAqaFkZjtHNVMzOfSWg31tK6VfCyy6pgB%2BB8ZI%2FDDEwcbNBjqwAZcvWNKbpIWtHX3BpFxRGOHxvGhfEC07W4EuGnrwiTDMTXbH9wtoPzobbQJ0Aixadx79OzVMvrh5uD33t7wVYclyFKJDIVm3zqvZ%2BrHJaBC2sv0LpYuQlE45Y1ZOv0FODG5jKuS46YIk0uWLqxcok6Yc5nehvtl6iFlSX45%2FGgh2B0TucH8qxfAjj7bIqNM3m1A0gZ99wk%2FcefEJCvdwsgztl2m8BPhgIYhr2YtXHe%2Br&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PB3VZNHKQU%2F20260311%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260311T172236Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=67d4574a497cc2505e78186a15f8a0e3d2a88ecd42288a3bce977f3236694bfa", "filename": "download.jpeg", "uploaded_by": { "id": 424549, "company_id": 10004, "name": "Vinay Forwarder", "firstname": "Vinay", "lastname": "Forwarder", "contact": { "email": "vinay.band@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Compliance Officer FWD ", "Field Agent", "Accountant", "MBSiQ", "Transportation FWD" ], "self": "http://stg-api.mbsisystems.com/api/employees/424549", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 17:21:45", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-11 17:21:45", "created_at": "2026-03-11T17:21:45.000000Z" } }, { "id": 180461048, "type": { "id": 6, "name": "Right side", "always_show": 1, "is_required": 1, "type": "photos", "created_at": "2020-01-20 15:12:12", "updated_at": "2022-02-16 11:51:49", "deleted_at": null }, "order_attachment_type_id": 6, "recovery_has_damage_type_location_id": null, "order_id": 57070277, "name": "standard-right-side", "photo_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/original/10004/424549/2026/03/11/jvKunXJD3CdP/car.jpeg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCAicqNV2%2FnhXV56JMQ97SSa6FVs%2F7JBUw5qPjT0%2FjuNwIhAOYpCYyP1MFH7y0N9waFnGyOs5dq8ne%2BVFMaBgRMgSAvKrkFCGIQAxoMOTU2MTMyMDIxMTg3IgzRCiWWxf6z8CBeZd4qlgXuf4u8M3rLPFHP2WrmJ%2BMV0ksqZh2VfSzj5ALyRwtEf61usjFMMN%2FLq4xONMGnlZoiSvLTkZ%2BcFe9Lu0ZCdYb%2BlxapMN4HbWPMafNyBic%2B%2FZhTDNfxdFs1DSfvj91eebqa7DjcJYdgz5k2tBQAr6esECwKBmlu%2FaBE1nV7Olr0k%2B45ylgMVklCGxM%2BefSmUPnUu9Zbh4x5SlkkSGY0IvX0Q%2FBdkYh1L6hPcjpGlwf64RbvqgLY3zO24G1zWq%2FWs7cF66%2FJi2wnjeKLPHLhOR7GjN4h3UAVc00Ukg7%2BbosACEyeM8doHm4g4skO4W9RTQNBt8MRpeSvtif7pTa0cVYRSRjBBqDCQoVqsLFFaFpKEYZAHJ7A8zMpombQ4s3MUfRgrWVZAMWoQWVCP2aVYVRT%2Fb36LvltEyLGZrB8iDh89W4BgL2%2BdwNYr3kly6R8J097yBvn3SlpwnRlHX0kTixg%2FfMsLsgHZsbE%2FJiFz0wNKfLS5Xm%2FFRLlBti35NZqESxTqu%2FNVN2fBE15o%2FsuvnQCAIq4J2iZ0u875Zk5GrkXgpr%2F07Q9TPvMWiMYeBrwvRzYpmWFAWO0v52L%2BPiHFlXJn8JbL7r9s%2B9QHE%2F0VqqawIpfJITFBbpAY7hJtCLo50f3a3zWoCnowM64quvmU8vjZBdFzd0yTV6W1oc3gpCVOWIS3GZOamyRUspu5lCD2BgjpPc9E7xs0YJoY5FHRS4ijYpppU9X%2BzZz3LPCHV0yDNvq3Nx1YISuyuAx6vy1CFqZMw14oINNZhx0AWqeO6yutGX7v6qI%2FCvkd3FtjWjzLuec8bkEMW4WmF%2BW2scutI%2FA83AclBbl1CgAqaFkZjtHNVMzOfSWg31tK6VfCyy6pgB%2BB8ZI%2FDDEwcbNBjqwAZcvWNKbpIWtHX3BpFxRGOHxvGhfEC07W4EuGnrwiTDMTXbH9wtoPzobbQJ0Aixadx79OzVMvrh5uD33t7wVYclyFKJDIVm3zqvZ%2BrHJaBC2sv0LpYuQlE45Y1ZOv0FODG5jKuS46YIk0uWLqxcok6Yc5nehvtl6iFlSX45%2FGgh2B0TucH8qxfAjj7bIqNM3m1A0gZ99wk%2FcefEJCvdwsgztl2m8BPhgIYhr2YtXHe%2Br&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PB3VZNHKQU%2F20260311%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260311T172236Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=1c952de8b4a953c71d0b5ac22970778820b474944234493ea36257308e299362", "filename": "car.jpeg", "uploaded_by": { "id": 424549, "company_id": 10004, "name": "Vinay Forwarder", "firstname": "Vinay", "lastname": "Forwarder", "contact": { "email": "vinay.band@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Compliance Officer FWD ", "Field Agent", "Accountant", "MBSiQ", "Transportation FWD" ], "self": "http://stg-api.mbsisystems.com/api/employees/424549", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 17:21:43", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-11 17:21:43", "created_at": "2026-03-11T17:21:43.000000Z" } } ], "meta": { "standard_photos": [ "standard-a-r-general-photo", "standard-l-f-fender", "standard-front:-center", "standard-r-f-fender", "standard-right-side", "standard-r-r-fender", "standard-rear:-center", "standard-license-plate", "standard-l-r-fender", "standard-left-side", "standard-vin", "standard-interior-photos", "standard-additional-photos", "standard-aftermarket-items", "standard-center-dash", "standard-open-glove-box", "standard-open-console", "standard-console-shifter", "standard-front-seat", "standard-rear-seat", "standard-trunk-cargo", "standard-engine", "standard-airbags", "standard-additional-damage", "standard-tow-dollies-flatbed", "standard-odometer" ], "damage_locations": [], "required_photos": [ "standard-r-f-fender", "standard-r-r-fender", "standard-rear:-center", "standard-license-plate", "standard-l-r-fender", "standard-left-side", "standard-vin", "standard-interior-photos", "standard-odometer" ], "all_required_photos": [ "standard-l-f-fender", "standard-front:-center", "standard-r-f-fender", "standard-right-side", "standard-r-r-fender", "standard-rear:-center", "standard-license-plate", "standard-l-r-fender", "standard-left-side", "standard-vin", "standard-interior-photos", "standard-odometer" ], "total": 3 } } |
Create Recovery Photo
Description: This endpoint uploads and attaches a photo to a specific recovery record associated with an order.
Recovery photos are used to document the condition of the collateral at the time of recovery, including vehicle status, damages, surroundings, or other recovery-related observations. The image must be provided as a Base64 encoded string along with metadata such as the file name, image name, capture time, and attachment type.
URL: /api/v150/orders/{order_id}/recoveries/{recovery_id}/photos
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE | |
file_name | Name of the uploaded image | Yes | RecoveryPicture | |
image_name | Display name or label for the image | Yes |
Recovered | |
picture_time | Date and time when the photo was taken | Yes | 2026-03-08 23:23:00 | |
data | Base64 encoded string representing the image | Yes | dGhpcyBpcyBzYW1wbGUgcGRm…. | |
type | Identifier representing the photo type (refer to Order Attachment Type IDs reference table) | No | 2 |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57070277/recoveries/10120166/photos |
Request Body:
{ "file_name": "Picture", "image_name": "RecoverdPic", "picture_time": "2026-03-08 23:23:00", "data": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxIQDxAPEBAQEA….., } |
Response:
{ "data": { "order_id": "57070277", "type": 0, "case_attachment_type_id": 2, "recovery_has_damage_type_location_id": null, "attachment_id": 180461054, "recovery_id": 10120166 }, "status": "success" } |