Applies to integrated customers using the RecoveryConnect API
Recovery Operations
The Recovery Operations section contains endpoints used to create, retrieve, and update recovery records associated with an order. Recovery records represent the actual repossession or recovery event of the collateral.
These endpoints allow managing recovery details, condition reports, personal property records, and recovery-related photos.
Retrieve Order Recoveries
Description: This endpoint retrieves the list of recoveries associated with a specific order.
Recoveries represent events where collateral assets linked to an order have been recovered or repossessed. This endpoint returns recovery records related to the order, including recovery details and associated metadata.
URL: /api/v140/orders/{order_id}/recoveries
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57070277/recoveries |
Request Body: NA
Response:
{ "data": [ { "id": 10120166, "order_id": 57070277, "parent_id": null, "order_collaterals_id": 58850062, "color_id": 17, "damage_code": 1, "recovery_police": 10778, "pd_name": null, "access_to_interior": 0, "is_push_to_start": 0, "lpr_company": null, "lpr_type": null, "hail_damage": 0, "additional_damage": null, "airbags_deployed": 0, "accepted_at": null, "asset_recovery_photo": 0, "created_at": "2026-03-02 10:48:40", "deleted_at": null, "is_active": "1", "updated_at": "2026-03-02 10:48:42", "collateral_miles": 1000, "drivable": "Yes", "keys": "No", "keys_cut": 0, "recovery_police_badge": "", "recovery_police_notified_date": "2026-03-02 10:48:00", "client_estimated_fee": "20.00", "client_notes": "Automation Test", "recovery_date": "2026-03-02 10:48:00", "added_by": 87798, "lpnum": null, "lpstate": null, "lpexpire": null, "personals": 0, "personals_by": null, "personals_witnessed_by": null, "personals_spacenumber": null, "personals_numcontainers": null, "personals_completed": 0, "source": "W", "migration": null, "is_condition_completed": 1, "was_tow_dolly_used": 0, "privacy_data_removed": null, "privacy_data_removal_information": null, "ticket": null, "police_report": null, "days_stored": "10 days", "color": { "id": 17, "name": "Unknown Color", "hex": null, "created_at": null, "updated_at": null }, "recovered_by": [ { "id": 93200019, "recovery_id": 10120166, "employees_id": 188832, "created_at": "2026-03-02 10:48:40", "deleted_at": null, "company_id": 180338 } ], "personal_items": { "passengercabin": [], "glove": [], "trunk": [] }, "stored_at": { "id": 105734966, "parent_id": null, "recovery_id": 10120166, "order_collateral_id": 58850062, "addresses_id": 119863965, "address_id_by": null, "collateral_release_id": null, "collateral_status": null, "to_obj": null, "lotnum": null, "added_by": 87798, "loc_type": "Stored", "notes": "Automation test", "object_by": null, "object_id_by": null, "object": "Company", "object_id": 10004, "changes_location": 1, "sync_to_mmi": 1, "delivery_required": 0, "created_at": "2026-03-02 10:56:59", "updated_at": "2026-03-02 10:56:59", "location_date": "2026-03-02 10:56:00", "deleted_at": null, "address": { "id": 119863965, "name": "Texas_Test", "address_1": "4045 Renee Dr", "address_2": "", "unit": null, "zip": 42304, "type": 3, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:58:20", "updated_at": "2024-09-26 12:58:20", "deleted_at": null, "migration": null, "zip_code_details": { "zip_code_id": 42304, "zip_code": "75227", "zip_code_city_id": 42279, "city_name": "Dallas", "zip_code_state_id": 41534, "state_name": "Texas", "state_abbr": "TX", "state_county": "TX-Dallas", "zip_code_county_id": 42137, "county_name": "Dallas", "latitude": "32.766974", "longitude": "-96.683948", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-96.639322\",\"32.748751\",\"0.0\"],[\"-96.639872\",\"32.748751\",\"0.0\"],[\"-96.73115\",\"32.765797\",\"0.0\"],[\"-96.734449\",\"32.777894\",\"0.0\"],[\"-96.728951\",\"32.79219\",\"0.0\"],[\"-96.684961\",\"32.79219\",\"0.0\"],[\"-96.639322\",\"32.748751\",\"0.0\"]]]" } }, "lot_id": 1434580 }, "recovered_at": { "id": 105734962, "parent_id": null, "recovery_id": 10120166, "order_collateral_id": 58850062, "addresses_id": 120092337, "address_id_by": null, "collateral_release_id": null, "collateral_status": null, "to_obj": null, "lotnum": null, "added_by": 87798, "loc_type": "Recovered", "notes": null, "object_by": null, "object_id_by": null, "object": null, "object_id": null, "changes_location": 1, "sync_to_mmi": 1, "delivery_required": 0, "created_at": "2026-03-02 10:48:40", "updated_at": "2026-03-02 10:48:40", "location_date": "2026-03-02 10:48:00", "deleted_at": null, "address": { "id": 120092337, "name": "Home Address", "address_1": "A_Franklin2384 E Browning Pl Chandler", "address_2": "", "unit": "", "zip": 46177, "type": 1, "latitude": "0.00000000", "longitude": "0.00000000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2026-03-02 10:47:22", "updated_at": "2026-03-02 10:47:22", "deleted_at": null, "migration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } } }, "current_disposition": { "id": 105734966, "parent_id": null, "recovery_id": 10120166, "order_collateral_id": 58850062, "addresses_id": 119863965, "address_id_by": null, "collateral_release_id": null, "collateral_status": null, "to_obj": null, "lotnum": null, "added_by": 87798, "loc_type": "Stored", "notes": "Automation test", "object_by": null, "object_id_by": null, "object": "Company", "object_id": 10004, "changes_location": 1, "sync_to_mmi": 1, "delivery_required": 0, "created_at": "2026-03-02 10:56:59", "updated_at": "2026-03-02 10:56:59", "location_date": "2026-03-02 10:56:00", "deleted_at": null, "address": { "id": 119863965, "name": "Texas_Test", "address_1": "4045 Renee Dr", "address_2": "", "unit": null, "zip": 42304, "type": 3, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:58:20", "updated_at": "2024-09-26 12:58:20", "deleted_at": null, "migration": null, "zip_code_details": { "zip_code_id": 42304, "zip_code": "75227", "zip_code_city_id": 42279, "city_name": "Dallas", "zip_code_state_id": 41534, "state_name": "Texas", "state_abbr": "TX", "state_county": "TX-Dallas", "zip_code_county_id": 42137, "county_name": "Dallas", "latitude": "32.766974", "longitude": "-96.683948", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-96.639322\",\"32.748751\",\"0.0\"],[\"-96.639872\",\"32.748751\",\"0.0\"],[\"-96.73115\",\"32.765797\",\"0.0\"],[\"-96.734449\",\"32.777894\",\"0.0\"],[\"-96.728951\",\"32.79219\",\"0.0\"],[\"-96.684961\",\"32.79219\",\"0.0\"],[\"-96.639322\",\"32.748751\",\"0.0\"]]]" } } }, "recovery_assignment_id": null, "damage_locations": [], "personals_address_id": 0, "lpr_recovery": 0, "client_id": 65690, "client_name": "Demo Bank & Trust MRS", "company_orderno": 103096, "vin": "1G1AK15F467847310", "recovery_police_details": { "id": 10778, "name": "105 New York Police Department", "address": { "id": 778, "name": null, "address_1": "7660 Elias Mews Suite 266", "address_2": "", "state_abbr": "NA", "city_name": "Unknown", "zip_code": "00000", "county_name": "Unknown", "longitude": "11.15739536", "latitude": "47.26394272", "unit": null }, "phones": [ { "id": 2340, "type": 2, "mobile_carrier_id": null, "number": "630-384-6632", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2023-09-28 08:50:06", "deleted_at": null, "migration": null, "address_with_number": "630-384-6632 - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 2340 } }, { "id": 2341, "type": 3, "mobile_carrier_id": null, "number": "", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2014-06-21 07:05:45", "deleted_at": null, "migration": null, "address_with_number": " - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 2341 } }, { "id": 2342, "type": 4, "mobile_carrier_id": null, "number": "", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2014-06-21 07:05:45", "deleted_at": null, "migration": null, "address_with_number": " - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 2342 } }, { "id": 8593598, "type": 4, "mobile_carrier_id": null, "number": "364-780-6245", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2020-11-03 01:30:22", "updated_at": "2023-09-28 10:51:37", "deleted_at": null, "migration": null, "address_with_number": "364-780-6245 - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 8593598 } } ] }, "service_provider": { "id": 49170, "order_id": 57070277, "recovery_id": 10120166, "service_provider_id": 180338, "address_id": 6075318, "created_at": "2026-03-02 10:48:40", "updated_at": "2026-03-02 10:48:40" } } ], "meta": { "company_addresses": [ { "id": 4, "name": "Main", "address_1": "2345 Forwarding Comp Strret", "address_2": "", "unit": null, "zip": 34736, "type": 1, "latitude": "24.11170100", "longitude": "-27.18551000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2014-06-12 11:07:01", "updated_at": "2025-12-09 11:29:43", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-03-01", "zip_code_details": { "zip_code_id": 34736, "zip_code": "57201", "zip_code_city_id": 34736, "city_name": "Watertown", "zip_code_state_id": 34652, "state_name": "South Dakota", "state_abbr": "SD", "state_county": "SD-Codington", "zip_code_county_id": 34736, "county_name": "Codington", "latitude": "44.902615", "longitude": "-97.121324", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-97.370099\",\"44.847541\",\"0.0\"],[\"-97.289818\",\"44.948717\",\"0.0\"],[\"-97.144102\",\"45.093333\",\"0.0\"],[\"-96.882914\",\"45.049343\",\"0.0\"],[\"-96.882364\",\"44.97676\",\"0.0\"],[\"-96.923605\",\"44.904727\",\"0.0\"],[\"-96.923605\",\"44.889881\",\"0.0\"],[\"-96.925254\",\"44.804101\",\"0.0\"],[\"-97.127056\",\"44.788705\",\"0.0\"],[\"-97.370099\",\"44.847541\",\"0.0\"]]]" } }, { "id": 5493358, "name": "Regression Testing", "address_1": "11787 International Dr", "address_2": "", "unit": "", "zip": 23977, "type": 4, "latitude": "28.39301400", "longitude": "-81.46568800", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2020-07-01 15:18:52", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-03-28", "zip_code_details": { "zip_code_id": 23977, "zip_code": "32821", "zip_code_city_id": 23958, "city_name": "Orlando", "zip_code_state_id": 23482, "state_name": "Florida", "state_abbr": "FL", "state_county": "FL-Orange", "zip_code_county_id": 23886, "county_name": "Orange", "latitude": "28.379055", "longitude": "-81.467846", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-81.514831\",\"28.347333\",\"0.0\"],[\"-81.533069\",\"28.347333\",\"0.0\"],[\"-81.504652\",\"28.377658\",\"0.0\"],[\"-81.475812\",\"28.409892\",\"0.0\"],[\"-81.422796\",\"28.42198\",\"0.0\"],[\"-81.487687\",\"28.347121\",\"0.0\"],[\"-81.514831\",\"28.347333\",\"0.0\"]]]" } }, { "id": 5493360, "name": "Regression Testing", "address_1": "2301 West Dunlap", "address_2": "", "unit": "", "zip": 46361, "type": 4, "latitude": "32.25969900", "longitude": "-112.90588000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2020-07-01 15:18:52", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-01-07", "zip_code_details": { "zip_code_id": 46361, "zip_code": "85321", "zip_code_city_id": 46361, "city_name": "Ajo", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Pima", "zip_code_county_id": 46361, "county_name": "Pima", "latitude": "32.385764", "longitude": "-112.866344", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.887431\",\"32.505158\",\"0.0\"],[\"-112.574555\",\"32.505158\",\"0.0\"],[\"-112.727419\",\"32.173037\",\"0.0\"],[\"-112.905577\",\"32.19998\",\"0.0\"],[\"-112.887431\",\"32.505158\",\"0.0\"]]]" } }, { "id": 20175560, "name": "shilpatest address 2", "address_1": "2301 West Dunlap Ave", "address_2": "", "unit": "", "zip": 46199, "type": 3, "latitude": "33.56764800", "longitude": "-112.10921200", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2020-11-13 00:33:34", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-09-17", "zip_code_details": { "zip_code_id": 46199, "zip_code": "85023", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.632395", "longitude": "-112.111758", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.074723\",\"33.607648\",\"0.0\"],[\"-112.117063\",\"33.610947\",\"0.0\"],[\"-112.113764\",\"33.654936\",\"0.0\"],[\"-112.074173\",\"33.654936\",\"0.0\"],[\"-112.074723\",\"33.607648\",\"0.0\"]]]" } }, { "id": 91668982, "name": "address 1as main location Phoenix AZ 85019 edited", "address_1": "69373 Kailyn Points Suite 411", "address_2": "", "unit": "", "zip": 46296, "type": 3, "latitude": "33.33123000", "longitude": "-111.64222400", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2022-07-26 03:37:45", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-04-24", "zip_code_details": { "zip_code_id": 46296, "zip_code": "85212", "zip_code_city_id": 46285, "city_name": "Mesa", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.342880", "longitude": "-111.621592", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-111.686515\",\"33.288723\",\"0.0\"],[\"-111.687615\",\"33.365155\",\"0.0\"],[\"-111.601835\",\"33.378902\",\"0.0\"],[\"-111.583689\",\"33.362406\",\"0.0\"],[\"-111.686515\",\"33.288723\",\"0.0\"]]]" } }, { "id": 119863964, "name": "Test_AZ", "address_1": "5138 E 27th St", "address_2": "", "unit": null, "zip": 46515, "type": 1, "latitude": "-90.00000000", "longitude": "-120.00000000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:46:51", "updated_at": "2025-12-09 11:30:11", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-04-26", "zip_code_details": { "zip_code_id": 46515, "zip_code": "85711", "zip_code_city_id": 46505, "city_name": "Tucson", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Pima", "zip_code_county_id": 46361, "county_name": "Pima", "latitude": "32.218469", "longitude": "-110.887678", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-110.857861\",\"32.192282\",\"0.0\"],[\"-110.875457\",\"32.192282\",\"0.0\"],[\"-110.908999\",\"32.196131\",\"0.0\"],[\"-110.909549\",\"32.207129\",\"0.0\"],[\"-110.909549\",\"32.236272\",\"0.0\"],[\"-110.857861\",\"32.235722\",\"0.0\"],[\"-110.857861\",\"32.192282\",\"0.0\"]]]" } }, { "id": 119863965, "name": "Texas_Test", "address_1": "4045 Renee Dr", "address_2": "", "unit": null, "zip": 42304, "type": 3, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:58:20", "updated_at": "2024-09-26 12:58:20", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-01-22", "zip_code_details": { "zip_code_id": 42304, "zip_code": "75227", "zip_code_city_id": 42279, "city_name": "Dallas", "zip_code_state_id": 41534, "state_name": "Texas", "state_abbr": "TX", "state_county": "TX-Dallas", "zip_code_county_id": 42137, "county_name": "Dallas", "latitude": "32.766974", "longitude": "-96.683948", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-96.639322\",\"32.748751\",\"0.0\"],[\"-96.639872\",\"32.748751\",\"0.0\"],[\"-96.73115\",\"32.765797\",\"0.0\"],[\"-96.734449\",\"32.777894\",\"0.0\"],[\"-96.728951\",\"32.79219\",\"0.0\"],[\"-96.684961\",\"32.79219\",\"0.0\"],[\"-96.639322\",\"32.748751\",\"0.0\"]]]" } }, { "id": 119864510, "name": "Testing Storage Location Neelima via API", "address_1": "3620 W Greenway Rd3, Phoenix, AZ Phoenix AZ 85014", "address_2": "3620 W Greenway", "unit": "1234", "zip": 46191, "type": 4, "latitude": "33.62569100", "longitude": "-112.13673400", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 16:12:51", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-04-26", "zip_code_details": { "zip_code_id": 46191, "zip_code": "85015", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.507977", "longitude": "-112.101173", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.091219\",\"33.480628\",\"0.0\"],[\"-112.100017\",\"33.480628\",\"0.0\"],[\"-112.113214\",\"33.480628\",\"0.0\"],[\"-112.112664\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.480628\",\"0.0\"]]]" } }, { "id": 119864511, "name": "Testing Storage Location Neelima via API", "address_1": "36201 W Greenway Rd3, Phoenix, AZ Phoenix AZ 85014", "address_2": "3620 W Greenway", "unit": "12314", "zip": 46191, "type": 4, "latitude": "33.49917800", "longitude": "-112.11048300", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 16:13:48", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-11-25", "zip_code_details": { "zip_code_id": 46191, "zip_code": "85015", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.507977", "longitude": "-112.101173", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.091219\",\"33.480628\",\"0.0\"],[\"-112.100017\",\"33.480628\",\"0.0\"],[\"-112.113214\",\"33.480628\",\"0.0\"],[\"-112.112664\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.480628\",\"0.0\"]]]" } }, { "id": 120007065, "name": "storage", "address_1": "871 3rd St NW", "address_2": "", "unit": null, "zip": 47465, "type": 4, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-07-18 13:05:03", "updated_at": "2025-07-18 13:05:03", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 47465, "zip_code": "90007", "zip_code_city_id": 47459, "city_name": "Los Angeles", "zip_code_state_id": 47459, "state_name": "California", "state_abbr": "CA", "state_county": "CA-Los Angeles", "zip_code_county_id": 47459, "county_name": "Los Angeles", "latitude": "34.026525", "longitude": "-118.282408", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-118.300351\",\"34.018401\",\"0.0\"],[\"-118.300351\",\"34.039845\",\"0.0\"],[\"-118.282756\",\"34.039296\",\"0.0\"],[\"-118.26461\",\"34.031048\",\"0.0\"],[\"-118.273958\",\"34.012902\",\"0.0\"],[\"-118.300351\",\"34.018401\",\"0.0\"]]]" } }, { "id": 120011832, "name": "Automation Address 2025-07-29T10:07:55.190845098", "address_1": "Main Dallas, Arizona 2025-07-29T10:07:55.190845098", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "32.77666420", "longitude": "-96.79698790", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-07-29 10:08:00", "updated_at": "2025-07-29 10:08:00", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120033931, "name": "Automation Address 2025-09-24T10:01:44.109665123", "address_1": "Main Dallas, Arizona 2025-09-24T10:01:44.109665123", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44822660", "longitude": "-112.07767810", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-09-24 10:01:50", "updated_at": "2025-09-24 10:01:50", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120036405, "name": "Automation Address 2025-09-30T10:11:59.329940500", "address_1": "Main Dallas, Arizona 2025-09-30T10:11:59.329940500", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-09-30 10:12:10", "updated_at": "2025-09-30 10:12:10", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120037621, "name": "Automation Address 2025-10-03T09:30:10.064691972", "address_1": "Main Dallas, Arizona 2025-10-03T09:30:10.064691972", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-10-03 09:30:15", "updated_at": "2025-10-03 09:30:15", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120087005, "name": "Automation Address 2026-02-11T19:26:56.642895100", "address_1": "Main Dallas, Arizona 2026-02-11T19:26:56.642895100", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2026-02-11 13:57:03", "updated_at": "2026-02-11 13:57:03", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120092355, "name": "Automation Address 2026-03-02T17:17:10.949979500", "address_1": "Main Dallas, Arizona 2026-03-02T17:17:10.949979500", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2026-03-02 11:47:17", "updated_at": "2026-03-02 11:47:17", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } } ], "colors": [ { "id": 1, "name": "Black", "hex": "", "created_at": null, "updated_at": null }, { "id": 2, "name": "White", "hex": "", "created_at": null, "updated_at": null }, { "id": 3, "name": "Red", "hex": "", "created_at": null, "updated_at": null }, { "id": 4, "name": "Yellow", "hex": "", "created_at": null, "updated_at": null }, { "id": 5, "name": "Blue", "hex": "", "created_at": null, "updated_at": null }, { "id": 6, "name": "Green", "hex": "", "created_at": null, "updated_at": null }, { "id": 7, "name": "Silver", "hex": "", "created_at": null, "updated_at": null }, { "id": 8, "name": "Gold", "hex": "", "created_at": null, "updated_at": null }, { "id": 9, "name": "Brown", "hex": "", "created_at": null, "updated_at": null }, { "id": 10, "name": "Orange", "hex": "", "created_at": null, "updated_at": null }, { "id": 11, "name": "Purple", "hex": "", "created_at": null, "updated_at": null }, { "id": 12, "name": "Tan", "hex": "", "created_at": null, "updated_at": null }, { "id": 13, "name": "Maroon", "hex": "", "created_at": null, "updated_at": null }, { "id": 14, "name": "Teal", "hex": "", "created_at": null, "updated_at": null }, { "id": 15, "name": "Gray", "hex": "", "created_at": null, "updated_at": null }, { "id": 16, "name": "Copper", "hex": "", "created_at": null, "updated_at": null }, { "id": 17, "name": "Unknown Color", "hex": null, "created_at": null, "updated_at": null }, { "id": 19, "name": "Pink", "hex": null, "created_at": null, "updated_at": null }, { "id": 20, "name": "Light Blue", "hex": null, "created_at": null, "updated_at": null }, { "id": 22, "name": "Crystal Red Tintcoat", "hex": null, "created_at": null, "updated_at": null } ] } } |
Create Recovery
Description: This endpoint creates a recovery record associated with a specific order.
A recovery represents an event where collateral linked to an order has been recovered or repossessed. This endpoint allows users to record recovery details such as the recovered collateral, recovery date, police notification details, vehicle condition, and other recovery-related metadata.
URL: /api/v140/orders/{order_id}/recoveries
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE | |
collateral_id | Unique identifier of the collateral being recovered | Yes | 2423221 | |
recovered_by | Employee ID of the recovery agent | Yes | 10098 | |
recovered_at | Identifier of the yard/location where collateral was recovered | Yes | 212 | |
recovery_date | Date and time of the recovery (YYYY-MM-DD HH:mm: ss) | Yes | 2019-10-17 23:23:00 | |
lpr_recovery | Flag indicating if recovery was through License Plate Recognition (LPR) | No | 0 | |
lpr_type |
Type of LPR used | No | 1 | |
lpr_company | Identifier of the LPR company | No | 2424 | |
police_agency_id | The identifier of the police agency notified | Yes | 2421313 | |
recovery_police_notified_date | Date and time when police were notified | Yes | 2019-10-17 23:23:00 | |
police_badge_id | Badge ID of the officer notified | No | 2424 | |
client_notes | Notes provided by the client | No | notesss | |
client_estimated_fee | Estimated fee from the client | No | 3 | |
access_to_interior | Flag indicating if the vehicle’s interior was accessed | No | 0 | |
keys | Flag indicating if keys were present | Yes | 0 | |
personals | Indicator of personal items found in the collateral | No | 2 | |
is_push_to_start | Flag indicating if the vehicle has push-to-start functionality | No | 1 | |
driveable | Indicator if the vehicle is drivable | Yes | 2 | |
color | Color of the recovered vehicle | Yes | white | |
miles | Odometer reading of the vehicle | Yes | 5000 | |
plate_number | Vehicle plate number | No | 2423221 | |
plate_state | State of the vehicle plate | No | OH | |
lpexpire_month | License plate expiration month | No | 2 | |
lpexpire_year | License plate expiration year | No | 2020 | |
damage_locations | List of damages with type/location IDs | No | [ { … } ] | |
id | Unique identifier of the damage record | No | 10024617 | |
damage_type_location_id | Identifier for the location of the damage on the asset | No | 29 | |
damage_type_id | Identifier for the type of damage (e.g., scratch, dent) | Yes | 1 | |
damage_id | Identifier for the type of damage reported | Yes | 2 | |
additional_damage | Free-text or extended description of any additional damage | No | null | |
hail_damage | Boolean/flag indicating if the asset has hail damage (0 = No, 1 = Yes) | Yes | 0 | |
stored_at | Identifier of the storage facility/location where the asset is kept | Yes | 22323 | |
keys_cut | Boolean/flag indicating if new keys were cut (0 = No, 1 = Yes) | No | 0 | |
airbags_deployed | Boolean/flag indicating if airbags were deployed (0 = No, 1 = Yes) | Yes | 0 | |
service_provider | Identifier of the service provider who handled the recovery | No | 141482 |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/16644931/recoveries |
Request Body:
{ "collateral_id": 2423221, "recovered_by": 10098, "recovered_at": 212, "recovery_date": "2019-10-17 23:23:00", "lpr_recovery": 0, "lpr_type": 1, "lpr_company": 2424, "police_agency_id": 2421313, "recovery_police_notified_date": "2019-10-17 23:23:00", "police_badge_id": 2424, "client_notes": "client note", "client_estimated_fee": 3, "access_to_interior": 0, "keys": 0, "personals": 2, "is_push_to_start": 1, "driveable": 2, "color": "white", "miles": 24, "plate_number": "2423221", "plate_state": "OH", "lpexpire_month": 2, "lpexpire_year": 2020, "damage_locations": [ { "id": 10024617, "recovery_id": 10098777, "damage_type_location_id": 29, "damage_type_id": 1, "created_at": "2025-02-14 20:47:21", "updated_at": "2025-02-14 20:47:21" } ], "damage_id": 2, "additional_damage": null, "hail_damage": 0, "stored_at": 22323, "keys_cut": 0, "airbags_deployed": 0, "service_provider": 141482 } |
Response:
{ "data": { "success": true, "recovery_id": 354644, "order_id": 805792 } } |
Retrieve Recovery Details
Description: This endpoint retrieves the details of a specific recovery associated with an order.
Recoveries represent events where collateral linked to an order has been recovered or repossessed. By providing the order ID and recovery ID, this endpoint returns detailed information related to the recovery event, including recovery metadata, collateral information, and associated recovery attributes.
URL: /api/v140/orders/{order_id}/recoveries/{recovery_id}
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57070277/recoveries/10120166 |
Request Body: NA
Response:
{ "data": { "id": 10120166, "order_id": 57070277, "parent_id": null, "order_collaterals_id": 58850062, "color_id": 17, "damage_code": 1, "recovery_police": 10778, "pd_name": null, "access_to_interior": 0, "is_push_to_start": 0, "lpr_company": null, "lpr_type": null, "hail_damage": 0, "additional_damage": null, "airbags_deployed": 0, "accepted_at": null, "asset_recovery_photo": 0, "created_at": "2026-03-02 10:48:40", "deleted_at": null, "is_active": "1", "updated_at": "2026-03-02 10:48:42", "collateral_miles": 1000, "drivable": "Yes", "keys": "No", "keys_cut": 0, "recovery_police_badge": "", "recovery_police_notified_date": "2026-03-02 10:48:00", "client_estimated_fee": "20.00", "client_notes": "Automation Test", "recovery_date": "2026-03-02 10:48:00", "added_by": 87798, "lpnum": null, "lpstate": null, "lpexpire": null, "personals": 0, "personals_by": null, "personals_witnessed_by": null, "personals_spacenumber": null, "personals_numcontainers": null, "personals_completed": 0, "source": "W", "migration": null, "is_condition_completed": 1, "was_tow_dolly_used": 0, "privacy_data_removed": null, "privacy_data_removal_information": null, "ticket": null, "police_report": null, "days_stored": "10 days", "color": { "id": 17, "name": "Unknown Color", "hex": null, "created_at": null, "updated_at": null }, "recovered_by": [ { "id": 93200019, "recovery_id": 10120166, "employees_id": 188832, "created_at": "2026-03-02 10:48:40", "deleted_at": null, "company_id": 180338 } ], "personal_items": { "passengercabin": [], "glove": [], "trunk": [] }, "stored_at": { "id": 105734966, "parent_id": null, "recovery_id": 10120166, "order_collateral_id": 58850062, "addresses_id": 119863965, "address_id_by": null, "collateral_release_id": null, "collateral_status": null, "to_obj": null, "lotnum": null, "added_by": 87798, "loc_type": "Stored", "notes": "Automation test", "object_by": null, "object_id_by": null, "object": "Company", "object_id": 10004, "changes_location": 1, "sync_to_mmi": 1, "delivery_required": 0, "created_at": "2026-03-02 10:56:59", "updated_at": "2026-03-02 10:56:59", "location_date": "2026-03-02 10:56:00", "deleted_at": null, "address": { "id": 119863965, "name": "Texas_Test", "address_1": "4045 Renee Dr", "address_2": "", "unit": null, "zip": 42304, "type": 3, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:58:20", "updated_at": "2024-09-26 12:58:20", "deleted_at": null, "migration": null, "zip_code_details": { "zip_code_id": 42304, "zip_code": "75227", "zip_code_city_id": 42279, "city_name": "Dallas", "zip_code_state_id": 41534, "state_name": "Texas", "state_abbr": "TX", "state_county": "TX-Dallas", "zip_code_county_id": 42137, "county_name": "Dallas", "latitude": "32.766974", "longitude": "-96.683948", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-96.639322\",\"32.748751\",\"0.0\"],[\"-96.639872\",\"32.748751\",\"0.0\"],[\"-96.73115\",\"32.765797\",\"0.0\"],[\"-96.734449\",\"32.777894\",\"0.0\"],[\"-96.728951\",\"32.79219\",\"0.0\"],[\"-96.684961\",\"32.79219\",\"0.0\"],[\"-96.639322\",\"32.748751\",\"0.0\"]]]" } }, "lot_id": 1434580 }, "recovered_at": { "id": 105734962, "parent_id": null, "recovery_id": 10120166, "order_collateral_id": 58850062, "addresses_id": 120092337, "address_id_by": null, "collateral_release_id": null, "collateral_status": null, "to_obj": null, "lotnum": null, "added_by": 87798, "loc_type": "Recovered", "notes": null, "object_by": null, "object_id_by": null, "object": null, "object_id": null, "changes_location": 1, "sync_to_mmi": 1, "delivery_required": 0, "created_at": "2026-03-02 10:48:40", "updated_at": "2026-03-02 10:48:40", "location_date": "2026-03-02 10:48:00", "deleted_at": null, "address": { "id": 120092337, "name": "Home Address", "address_1": "A_Franklin2384 E Browning Pl Chandler", "address_2": "", "unit": "", "zip": 46177, "type": 1, "latitude": "0.00000000", "longitude": "0.00000000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2026-03-02 10:47:22", "updated_at": "2026-03-02 10:47:22", "deleted_at": null, "migration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } } }, "current_disposition": { "id": 105734966, "parent_id": null, "recovery_id": 10120166, "order_collateral_id": 58850062, "addresses_id": 119863965, "address_id_by": null, "collateral_release_id": null, "collateral_status": null, "to_obj": null, "lotnum": null, "added_by": 87798, "loc_type": "Stored", "notes": "Automation test", "object_by": null, "object_id_by": null, "object": "Company", "object_id": 10004, "changes_location": 1, "sync_to_mmi": 1, "delivery_required": 0, "created_at": "2026-03-02 10:56:59", "updated_at": "2026-03-02 10:56:59", "location_date": "2026-03-02 10:56:00", "deleted_at": null, "address": { "id": 119863965, "name": "Texas_Test", "address_1": "4045 Renee Dr", "address_2": "", "unit": null, "zip": 42304, "type": 3, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:58:20", "updated_at": "2024-09-26 12:58:20", "deleted_at": null, "migration": null, "zip_code_details": { "zip_code_id": 42304, "zip_code": "75227", "zip_code_city_id": 42279, "city_name": "Dallas", "zip_code_state_id": 41534, "state_name": "Texas", "state_abbr": "TX", "state_county": "TX-Dallas", "zip_code_county_id": 42137, "county_name": "Dallas", "latitude": "32.766974", "longitude": "-96.683948", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-96.639322\",\"32.748751\",\"0.0\"],[\"-96.639872\",\"32.748751\",\"0.0\"],[\"-96.73115\",\"32.765797\",\"0.0\"],[\"-96.734449\",\"32.777894\",\"0.0\"],[\"-96.728951\",\"32.79219\",\"0.0\"],[\"-96.684961\",\"32.79219\",\"0.0\"],[\"-96.639322\",\"32.748751\",\"0.0\"]]]" } } }, "recovery_assignment_id": null, "damage_locations": [], "personals_address_id": 0, "lpr_recovery": 0, "client_id": 65690, "client_name": "Demo Bank & Trust MRS", "company_orderno": 103096, "vin": "1G1AK15F467847310", "recovery_police_details": { "id": 10778, "name": "105 New York Police Department", "address": { "id": 778, "name": null, "address_1": "7660 Elias Mews Suite 266", "address_2": "", "state_abbr": "NA", "city_name": "Unknown", "zip_code": "00000", "county_name": "Unknown", "longitude": "11.15739536", "latitude": "47.26394272", "unit": null }, "phones": [ { "id": 2340, "type": 2, "mobile_carrier_id": null, "number": "630-384-6632", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2023-09-28 08:50:06", "deleted_at": null, "migration": null, "address_with_number": "630-384-6632 - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 2340 } }, { "id": 2341, "type": 3, "mobile_carrier_id": null, "number": "", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2014-06-21 07:05:45", "deleted_at": null, "migration": null, "address_with_number": " - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 2341 } }, { "id": 2342, "type": 4, "mobile_carrier_id": null, "number": "", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2014-06-21 07:05:45", "deleted_at": null, "migration": null, "address_with_number": " - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 2342 } }, { "id": 8593598, "type": 4, "mobile_carrier_id": null, "number": "364-780-6245", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2020-11-03 01:30:22", "updated_at": "2023-09-28 10:51:37", "deleted_at": null, "migration": null, "address_with_number": "364-780-6245 - 105 New York Police Department (7660 Elias Mews Suite 266 Unknown NA 00000) ", "pivot": { "address_id": 778, "phone_id": 8593598 } } ] }, "service_provider": { "id": 49170, "order_id": 57070277, "recovery_id": 10120166, "service_provider_id": 180338, "address_id": 6075318, "created_at": "2026-03-02 10:48:40", "updated_at": "2026-03-02 10:48:40" } }, "meta": { "company_addresses": [ { "id": 4, "name": "Main", "address_1": "2345 Forwarding Comp Strret", "address_2": "", "unit": null, "zip": 34736, "type": 1, "latitude": "24.11170100", "longitude": "-27.18551000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2014-06-12 11:07:01", "updated_at": "2025-12-09 11:29:43", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-03-01", "zip_code_details": { "zip_code_id": 34736, "zip_code": "57201", "zip_code_city_id": 34736, "city_name": "Watertown", "zip_code_state_id": 34652, "state_name": "South Dakota", "state_abbr": "SD", "state_county": "SD-Codington", "zip_code_county_id": 34736, "county_name": "Codington", "latitude": "44.902615", "longitude": "-97.121324", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-97.370099\",\"44.847541\",\"0.0\"],[\"-97.289818\",\"44.948717\",\"0.0\"],[\"-97.144102\",\"45.093333\",\"0.0\"],[\"-96.882914\",\"45.049343\",\"0.0\"],[\"-96.882364\",\"44.97676\",\"0.0\"],[\"-96.923605\",\"44.904727\",\"0.0\"],[\"-96.923605\",\"44.889881\",\"0.0\"],[\"-96.925254\",\"44.804101\",\"0.0\"],[\"-97.127056\",\"44.788705\",\"0.0\"],[\"-97.370099\",\"44.847541\",\"0.0\"]]]" } }, { "id": 5493358, "name": "Regression Testing", "address_1": "11787 International Dr", "address_2": "", "unit": "", "zip": 23977, "type": 4, "latitude": "28.39301400", "longitude": "-81.46568800", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2020-07-01 15:18:52", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-03-28", "zip_code_details": { "zip_code_id": 23977, "zip_code": "32821", "zip_code_city_id": 23958, "city_name": "Orlando", "zip_code_state_id": 23482, "state_name": "Florida", "state_abbr": "FL", "state_county": "FL-Orange", "zip_code_county_id": 23886, "county_name": "Orange", "latitude": "28.379055", "longitude": "-81.467846", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-81.514831\",\"28.347333\",\"0.0\"],[\"-81.533069\",\"28.347333\",\"0.0\"],[\"-81.504652\",\"28.377658\",\"0.0\"],[\"-81.475812\",\"28.409892\",\"0.0\"],[\"-81.422796\",\"28.42198\",\"0.0\"],[\"-81.487687\",\"28.347121\",\"0.0\"],[\"-81.514831\",\"28.347333\",\"0.0\"]]]" } }, { "id": 5493360, "name": "Regression Testing", "address_1": "2301 West Dunlap", "address_2": "", "unit": "", "zip": 46361, "type": 4, "latitude": "32.25969900", "longitude": "-112.90588000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2020-07-01 15:18:52", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-01-07", "zip_code_details": { "zip_code_id": 46361, "zip_code": "85321", "zip_code_city_id": 46361, "city_name": "Ajo", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Pima", "zip_code_county_id": 46361, "county_name": "Pima", "latitude": "32.385764", "longitude": "-112.866344", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.887431\",\"32.505158\",\"0.0\"],[\"-112.574555\",\"32.505158\",\"0.0\"],[\"-112.727419\",\"32.173037\",\"0.0\"],[\"-112.905577\",\"32.19998\",\"0.0\"],[\"-112.887431\",\"32.505158\",\"0.0\"]]]" } }, { "id": 20175560, "name": "shilpatest address 2", "address_1": "2301 West Dunlap Ave", "address_2": "", "unit": "", "zip": 46199, "type": 3, "latitude": "33.56764800", "longitude": "-112.10921200", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2020-11-13 00:33:34", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-09-17", "zip_code_details": { "zip_code_id": 46199, "zip_code": "85023", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.632395", "longitude": "-112.111758", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.074723\",\"33.607648\",\"0.0\"],[\"-112.117063\",\"33.610947\",\"0.0\"],[\"-112.113764\",\"33.654936\",\"0.0\"],[\"-112.074173\",\"33.654936\",\"0.0\"],[\"-112.074723\",\"33.607648\",\"0.0\"]]]" } }, { "id": 91668982, "name": "address 1as main location Phoenix AZ 85019 edited", "address_1": "69373 Kailyn Points Suite 411", "address_2": "", "unit": "", "zip": 46296, "type": 3, "latitude": "33.33123000", "longitude": "-111.64222400", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2022-07-26 03:37:45", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-04-24", "zip_code_details": { "zip_code_id": 46296, "zip_code": "85212", "zip_code_city_id": 46285, "city_name": "Mesa", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.342880", "longitude": "-111.621592", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-111.686515\",\"33.288723\",\"0.0\"],[\"-111.687615\",\"33.365155\",\"0.0\"],[\"-111.601835\",\"33.378902\",\"0.0\"],[\"-111.583689\",\"33.362406\",\"0.0\"],[\"-111.686515\",\"33.288723\",\"0.0\"]]]" } }, { "id": 119863964, "name": "Test_AZ", "address_1": "5138 E 27th St", "address_2": "", "unit": null, "zip": 46515, "type": 1, "latitude": "-90.00000000", "longitude": "-120.00000000", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:46:51", "updated_at": "2025-12-09 11:30:11", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-04-26", "zip_code_details": { "zip_code_id": 46515, "zip_code": "85711", "zip_code_city_id": 46505, "city_name": "Tucson", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Pima", "zip_code_county_id": 46361, "county_name": "Pima", "latitude": "32.218469", "longitude": "-110.887678", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-110.857861\",\"32.192282\",\"0.0\"],[\"-110.875457\",\"32.192282\",\"0.0\"],[\"-110.908999\",\"32.196131\",\"0.0\"],[\"-110.909549\",\"32.207129\",\"0.0\"],[\"-110.909549\",\"32.236272\",\"0.0\"],[\"-110.857861\",\"32.235722\",\"0.0\"],[\"-110.857861\",\"32.192282\",\"0.0\"]]]" } }, { "id": 119863965, "name": "Texas_Test", "address_1": "4045 Renee Dr", "address_2": "", "unit": null, "zip": 42304, "type": 3, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 12:58:20", "updated_at": "2024-09-26 12:58:20", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-01-22", "zip_code_details": { "zip_code_id": 42304, "zip_code": "75227", "zip_code_city_id": 42279, "city_name": "Dallas", "zip_code_state_id": 41534, "state_name": "Texas", "state_abbr": "TX", "state_county": "TX-Dallas", "zip_code_county_id": 42137, "county_name": "Dallas", "latitude": "32.766974", "longitude": "-96.683948", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-96.639322\",\"32.748751\",\"0.0\"],[\"-96.639872\",\"32.748751\",\"0.0\"],[\"-96.73115\",\"32.765797\",\"0.0\"],[\"-96.734449\",\"32.777894\",\"0.0\"],[\"-96.728951\",\"32.79219\",\"0.0\"],[\"-96.684961\",\"32.79219\",\"0.0\"],[\"-96.639322\",\"32.748751\",\"0.0\"]]]" } }, { "id": 119864510, "name": "Testing Storage Location Neelima via API", "address_1": "3620 W Greenway Rd3, Phoenix, AZ Phoenix AZ 85014", "address_2": "3620 W Greenway", "unit": "1234", "zip": 46191, "type": 4, "latitude": "33.62569100", "longitude": "-112.13673400", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 16:12:51", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-04-26", "zip_code_details": { "zip_code_id": 46191, "zip_code": "85015", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.507977", "longitude": "-112.101173", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.091219\",\"33.480628\",\"0.0\"],[\"-112.100017\",\"33.480628\",\"0.0\"],[\"-112.113214\",\"33.480628\",\"0.0\"],[\"-112.112664\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.480628\",\"0.0\"]]]" } }, { "id": 119864511, "name": "Testing Storage Location Neelima via API", "address_1": "36201 W Greenway Rd3, Phoenix, AZ Phoenix AZ 85014", "address_2": "3620 W Greenway", "unit": "12314", "zip": 46191, "type": 4, "latitude": "33.49917800", "longitude": "-112.11048300", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2024-09-26 16:13:48", "updated_at": "2025-04-04 12:56:57", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": "2025-11-25", "zip_code_details": { "zip_code_id": 46191, "zip_code": "85015", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.507977", "longitude": "-112.101173", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-112.091219\",\"33.480628\",\"0.0\"],[\"-112.100017\",\"33.480628\",\"0.0\"],[\"-112.113214\",\"33.480628\",\"0.0\"],[\"-112.112664\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.538364\",\"0.0\"],[\"-112.091219\",\"33.480628\",\"0.0\"]]]" } }, { "id": 120007065, "name": "storage", "address_1": "871 3rd St NW", "address_2": "", "unit": null, "zip": 47465, "type": 4, "latitude": null, "longitude": null, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-07-18 13:05:03", "updated_at": "2025-07-18 13:05:03", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 47465, "zip_code": "90007", "zip_code_city_id": 47459, "city_name": "Los Angeles", "zip_code_state_id": 47459, "state_name": "California", "state_abbr": "CA", "state_county": "CA-Los Angeles", "zip_code_county_id": 47459, "county_name": "Los Angeles", "latitude": "34.026525", "longitude": "-118.282408", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-118.300351\",\"34.018401\",\"0.0\"],[\"-118.300351\",\"34.039845\",\"0.0\"],[\"-118.282756\",\"34.039296\",\"0.0\"],[\"-118.26461\",\"34.031048\",\"0.0\"],[\"-118.273958\",\"34.012902\",\"0.0\"],[\"-118.300351\",\"34.018401\",\"0.0\"]]]" } }, { "id": 120011832, "name": "Automation Address 2025-07-29T10:07:55.190845098", "address_1": "Main Dallas, Arizona 2025-07-29T10:07:55.190845098", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "32.77666420", "longitude": "-96.79698790", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-07-29 10:08:00", "updated_at": "2025-07-29 10:08:00", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120033931, "name": "Automation Address 2025-09-24T10:01:44.109665123", "address_1": "Main Dallas, Arizona 2025-09-24T10:01:44.109665123", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44822660", "longitude": "-112.07767810", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-09-24 10:01:50", "updated_at": "2025-09-24 10:01:50", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120036405, "name": "Automation Address 2025-09-30T10:11:59.329940500", "address_1": "Main Dallas, Arizona 2025-09-30T10:11:59.329940500", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-09-30 10:12:10", "updated_at": "2025-09-30 10:12:10", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120037621, "name": "Automation Address 2025-10-03T09:30:10.064691972", "address_1": "Main Dallas, Arizona 2025-10-03T09:30:10.064691972", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2025-10-03 09:30:15", "updated_at": "2025-10-03 09:30:15", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120087005, "name": "Automation Address 2026-02-11T19:26:56.642895100", "address_1": "Main Dallas, Arizona 2026-02-11T19:26:56.642895100", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2026-02-11 13:57:03", "updated_at": "2026-02-11 13:57:03", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } }, { "id": 120092355, "name": "Automation Address 2026-03-02T17:17:10.949979500", "address_1": "Main Dallas, Arizona 2026-03-02T17:17:10.949979500", "address_2": "", "unit": "", "zip": 46177, "type": 4, "latitude": "33.44829480", "longitude": "-112.07254880", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2026-03-02 11:47:17", "updated_at": "2026-03-02 11:47:17", "deleted_at": null, "migration": null, "risc_certified_date": null, "risc_lot_expiration": null, "zip_code_details": { "zip_code_id": 46177, "zip_code": "85001", "zip_code_city_id": 46177, "city_name": "Phoenix", "zip_code_state_id": 46177, "state_name": "Arizona", "state_abbr": "AZ", "state_county": "AZ-Maricopa", "zip_code_county_id": 46177, "county_name": "Maricopa", "latitude": "33.449215", "longitude": "-112.069209", "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": null } } ], "colors": [ { "id": 1, "name": "Black", "hex": "", "created_at": null, "updated_at": null }, { "id": 2, "name": "White", "hex": "", "created_at": null, "updated_at": null }, { "id": 3, "name": "Red", "hex": "", "created_at": null, "updated_at": null }, { "id": 4, "name": "Yellow", "hex": "", "created_at": null, "updated_at": null }, { "id": 5, "name": "Blue", "hex": "", "created_at": null, "updated_at": null }, { "id": 6, "name": "Green", "hex": "", "created_at": null, "updated_at": null }, { "id": 7, "name": "Silver", "hex": "", "created_at": null, "updated_at": null }, { "id": 8, "name": "Gold", "hex": "", "created_at": null, "updated_at": null }, { "id": 9, "name": "Brown", "hex": "", "created_at": null, "updated_at": null }, { "id": 10, "name": "Orange", "hex": "", "created_at": null, "updated_at": null }, { "id": 11, "name": "Purple", "hex": "", "created_at": null, "updated_at": null }, { "id": 12, "name": "Tan", "hex": "", "created_at": null, "updated_at": null }, { "id": 13, "name": "Maroon", "hex": "", "created_at": null, "updated_at": null }, { "id": 14, "name": "Teal", "hex": "", "created_at": null, "updated_at": null }, { "id": 15, "name": "Gray", "hex": "", "created_at": null, "updated_at": null }, { "id": 16, "name": "Copper", "hex": "", "created_at": null, "updated_at": null }, { "id": 17, "name": "Unknown Color", "hex": null, "created_at": null, "updated_at": null }, { "id": 19, "name": "Pink", "hex": null, "created_at": null, "updated_at": null }, { "id": 20, "name": "Light Blue", "hex": null, "created_at": null, "updated_at": null }, { "id": 22, "name": "Crystal Red Tintcoat", "hex": null, "created_at": null, "updated_at": null } ] } } |
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/v140/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
| |
keys | Flag indicating if keys were present (1= Yes and 0 = No) | No | 1 |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/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" } |
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/v140/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/v140/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" } |
Retrieve Condition Report PDFs
Description: This endpoint retrieves the list of condition report documents (PDFs) attached to a specific recovery record.
Condition report documents typically contain details about the condition of the recovered collateral, including damage information, mileage, and other recovery-related observations. This endpoint returns the documents that have been uploaded for the specified recovery.
URL: /api/v140/orders/{order_id}/recoveries/{recovery_id}/documents
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57070277/recoveries/10120166/documents |
Request Body: NA
Response:
{ "data": [ { "id": 182214551, "type": { "id": 17, "name": "Condition Report", "always_show": 1, "is_required": 1, "type": "documents", "created_at": "2020-06-27 06:26:39", "updated_at": "2020-06-27 06:26:39", "deleted_at": null }, "order_attachment_type_id": 17, "order_id": 57070277, "name": "instruction-document", "document_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/documents/10004/408564/2026/03/11/zWO7Wukr5jnC/408564_test.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCO2cYlZF1WZIjVTNHpeHdBGI%2FtN7es%2BQWx0nM%2B1j2CsAIhAJmZI53AnlwpkzGjY1iCGpvmtzsD4ErBkUzn27J1Q90dKrkFCGEQAxoMOTU2MTMyMDIxMTg3IgxWIZIT9rRwEmsdUBwqlgUeLvHcGp6jWSbYBW5vW6J9w6Uo0PK44xqPCf%2FgTe7QZ87qadngzhmWSNaV%2By73D2bzR%2FqGVjxghfdxnBkvPTKY3OeOuDoJXCUkngSwa31QD9t3RIQMWDyheF4hqRX6StXlhX8SAHU0ynaIN0H806CyfqW3EA2rUgEDCTUXMTCmCXZxNHxsR53VFzy0MNi1%2B247CnVXJ4iMwHGjo0pDhH1M8prKBNmGEckSEFz6pQ0OE2SmLCPAqDPiU3ppjpB%2BgzJ6ydlLHUkFLsrDQO8zBwBhuhCcbIvG0pExPa2dJxHhvz6V2KcWvC%2BQVFal2eYHc2BBD3bGhWHDTWEi1EvE5HmXXAxTyJXRxHwBJ4Y2vSNAsSq3LicSVzx0qFugr%2FwQ8xKuVEfs8L1EyAN61XbmjkqIa1w2KkVlgLbQi%2Bcc6BbR%2BL4BHM5EzJBuZyC5LXkjXbZqOWwmAHs22%2BxsI2dVys4q%2B%2BnvPZyxuwzGkm575wrnMfPBgvABU4WnPwPRGSit9HIUJy0IU7jworr5wrjmPOVzNT1LLErrJdDW7I3RLVm9mPmkOKV0LiWd63bJwCaF8BYnbQW3O4s7YQEk7qi5QWFfEMaZ4CX3C2Pnq4OBx9cHoUkY%2FsjHReaQeB%2ByMu1ZEK9uXloGlMhBtz%2BF8nGzy6hEAMoQsyQuksOd8D3sobOhk8tcrFlYTwEKyMJeF%2Bfm5bACzww6jsZGoFOB13mz5m6%2BBJ43KUOrzjdAbQfGoGbZJkgoP%2BCtlfvoQ6mr1eeAACEbUQtZE0ECbICJywqeSoj%2BCgnxBDHPYpzqb5WTfJkOIDZ5uvBWSstuwVLZFyuBIrUjDIgUDNDDtTdeLnnv27PaDHOq4BE04lbEAM%2BNedGvVSd%2BfHk7lTCnpsbNBjqwAWe9SV%2BxBKn%2FIPm9VYAfUG0X9EvbUzqKublLmwZ3ouqL%2B8j8ByvceFcOxt9wIHUtC3iHpl5mB3qIFoXJoLR68glVp8i%2Fhto%2BngabpvBw%2Bz83nSMUYPVJV9s4a0%2B4l1juWNg6s1NwlU0LDTYQfbaka1NA6p4eGL59lX45eFWkypIRfhTbBDVTMuhQrca6EB32AVGHaNVNAXkPpPeUuHoQt6Mqrru3n2M3qnEmvgM7xNr4&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PBYIQ4TECY%2F20260311%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260311T163915Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=a45a4444b81a594fed938a634dff6edba0f3ca6405166df5ce57f1f732939c57", "filename": "408564_test.pdf", "uploaded_by": { "id": 408564, "company_id": 10004, "name": "sunil Forwarder", "firstname": "sunil", "lastname": "Forwarder", "contact": { "email": "sunil.vootkuri@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Accountant", "Compliance Officer FWD ", "Field Agent", "MBSiQ", "Remarketing FWD", "Team Lead", "Transportation FWD", "Vendor Manager", "VendorConnect Client", "VendorConnect Service Provider" ], "self": "http://stg-api.mbsisystems.com/api/employees/408564", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 16:32:51", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-11 16:32:51", "created_at": "2026-03-11T16:32:51.000000Z" } }, { "id": 182214552, "type": { "id": 17, "name": "Condition Report", "always_show": 1, "is_required": 1, "type": "documents", "created_at": "2020-06-27 06:26:39", "updated_at": "2020-06-27 06:26:39", "deleted_at": null }, "order_attachment_type_id": 17, "order_id": 57070277, "name": "instruction-document", "document_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/documents/10004/408564/2026/03/11/m3Fw4FE4Pkg4/408564_testing.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCO2cYlZF1WZIjVTNHpeHdBGI%2FtN7es%2BQWx0nM%2B1j2CsAIhAJmZI53AnlwpkzGjY1iCGpvmtzsD4ErBkUzn27J1Q90dKrkFCGEQAxoMOTU2MTMyMDIxMTg3IgxWIZIT9rRwEmsdUBwqlgUeLvHcGp6jWSbYBW5vW6J9w6Uo0PK44xqPCf%2FgTe7QZ87qadngzhmWSNaV%2By73D2bzR%2FqGVjxghfdxnBkvPTKY3OeOuDoJXCUkngSwa31QD9t3RIQMWDyheF4hqRX6StXlhX8SAHU0ynaIN0H806CyfqW3EA2rUgEDCTUXMTCmCXZxNHxsR53VFzy0MNi1%2B247CnVXJ4iMwHGjo0pDhH1M8prKBNmGEckSEFz6pQ0OE2SmLCPAqDPiU3ppjpB%2BgzJ6ydlLHUkFLsrDQO8zBwBhuhCcbIvG0pExPa2dJxHhvz6V2KcWvC%2BQVFal2eYHc2BBD3bGhWHDTWEi1EvE5HmXXAxTyJXRxHwBJ4Y2vSNAsSq3LicSVzx0qFugr%2FwQ8xKuVEfs8L1EyAN61XbmjkqIa1w2KkVlgLbQi%2Bcc6BbR%2BL4BHM5EzJBuZyC5LXkjXbZqOWwmAHs22%2BxsI2dVys4q%2B%2BnvPZyxuwzGkm575wrnMfPBgvABU4WnPwPRGSit9HIUJy0IU7jworr5wrjmPOVzNT1LLErrJdDW7I3RLVm9mPmkOKV0LiWd63bJwCaF8BYnbQW3O4s7YQEk7qi5QWFfEMaZ4CX3C2Pnq4OBx9cHoUkY%2FsjHReaQeB%2ByMu1ZEK9uXloGlMhBtz%2BF8nGzy6hEAMoQsyQuksOd8D3sobOhk8tcrFlYTwEKyMJeF%2Bfm5bACzww6jsZGoFOB13mz5m6%2BBJ43KUOrzjdAbQfGoGbZJkgoP%2BCtlfvoQ6mr1eeAACEbUQtZE0ECbICJywqeSoj%2BCgnxBDHPYpzqb5WTfJkOIDZ5uvBWSstuwVLZFyuBIrUjDIgUDNDDtTdeLnnv27PaDHOq4BE04lbEAM%2BNedGvVSd%2BfHk7lTCnpsbNBjqwAWe9SV%2BxBKn%2FIPm9VYAfUG0X9EvbUzqKublLmwZ3ouqL%2B8j8ByvceFcOxt9wIHUtC3iHpl5mB3qIFoXJoLR68glVp8i%2Fhto%2BngabpvBw%2Bz83nSMUYPVJV9s4a0%2B4l1juWNg6s1NwlU0LDTYQfbaka1NA6p4eGL59lX45eFWkypIRfhTbBDVTMuhQrca6EB32AVGHaNVNAXkPpPeUuHoQt6Mqrru3n2M3qnEmvgM7xNr4&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PBYIQ4TECY%2F20260311%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260311T163915Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=74e6df0f08b1ba7d595afe676d2ebca9e24743733fabd62d762541fc07bac23f", "filename": "408564_testing.pdf", "uploaded_by": { "id": 408564, "company_id": 10004, "name": "sunil Forwarder", "firstname": "sunil", "lastname": "Forwarder", "contact": { "email": "sunil.vootkuri@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Accountant", "Compliance Officer FWD ", "Field Agent", "MBSiQ", "Remarketing FWD", "Team Lead", "Transportation FWD", "Vendor Manager", "VendorConnect Client", "VendorConnect Service Provider" ], "self": "http://stg-api.mbsisystems.com/api/employees/408564", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 16:34:37", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-11 16:34:36", "created_at": "2026-03-11T16:34:37.000000Z" } }, { "id": 182214553, "type": { "id": 17, "name": "Condition Report", "always_show": 1, "is_required": 1, "type": "documents", "created_at": "2020-06-27 06:26:39", "updated_at": "2020-06-27 06:26:39", "deleted_at": null }, "order_attachment_type_id": 17, "order_id": 57070277, "name": "instruction-document", "document_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/documents/10004/408564/2026/03/11/kKe3MsJk5daX/408564_testing.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCO2cYlZF1WZIjVTNHpeHdBGI%2FtN7es%2BQWx0nM%2B1j2CsAIhAJmZI53AnlwpkzGjY1iCGpvmtzsD4ErBkUzn27J1Q90dKrkFCGEQAxoMOTU2MTMyMDIxMTg3IgxWIZIT9rRwEmsdUBwqlgUeLvHcGp6jWSbYBW5vW6J9w6Uo0PK44xqPCf%2FgTe7QZ87qadngzhmWSNaV%2By73D2bzR%2FqGVjxghfdxnBkvPTKY3OeOuDoJXCUkngSwa31QD9t3RIQMWDyheF4hqRX6StXlhX8SAHU0ynaIN0H806CyfqW3EA2rUgEDCTUXMTCmCXZxNHxsR53VFzy0MNi1%2B247CnVXJ4iMwHGjo0pDhH1M8prKBNmGEckSEFz6pQ0OE2SmLCPAqDPiU3ppjpB%2BgzJ6ydlLHUkFLsrDQO8zBwBhuhCcbIvG0pExPa2dJxHhvz6V2KcWvC%2BQVFal2eYHc2BBD3bGhWHDTWEi1EvE5HmXXAxTyJXRxHwBJ4Y2vSNAsSq3LicSVzx0qFugr%2FwQ8xKuVEfs8L1EyAN61XbmjkqIa1w2KkVlgLbQi%2Bcc6BbR%2BL4BHM5EzJBuZyC5LXkjXbZqOWwmAHs22%2BxsI2dVys4q%2B%2BnvPZyxuwzGkm575wrnMfPBgvABU4WnPwPRGSit9HIUJy0IU7jworr5wrjmPOVzNT1LLErrJdDW7I3RLVm9mPmkOKV0LiWd63bJwCaF8BYnbQW3O4s7YQEk7qi5QWFfEMaZ4CX3C2Pnq4OBx9cHoUkY%2FsjHReaQeB%2ByMu1ZEK9uXloGlMhBtz%2BF8nGzy6hEAMoQsyQuksOd8D3sobOhk8tcrFlYTwEKyMJeF%2Bfm5bACzww6jsZGoFOB13mz5m6%2BBJ43KUOrzjdAbQfGoGbZJkgoP%2BCtlfvoQ6mr1eeAACEbUQtZE0ECbICJywqeSoj%2BCgnxBDHPYpzqb5WTfJkOIDZ5uvBWSstuwVLZFyuBIrUjDIgUDNDDtTdeLnnv27PaDHOq4BE04lbEAM%2BNedGvVSd%2BfHk7lTCnpsbNBjqwAWe9SV%2BxBKn%2FIPm9VYAfUG0X9EvbUzqKublLmwZ3ouqL%2B8j8ByvceFcOxt9wIHUtC3iHpl5mB3qIFoXJoLR68glVp8i%2Fhto%2BngabpvBw%2Bz83nSMUYPVJV9s4a0%2B4l1juWNg6s1NwlU0LDTYQfbaka1NA6p4eGL59lX45eFWkypIRfhTbBDVTMuhQrca6EB32AVGHaNVNAXkPpPeUuHoQt6Mqrru3n2M3qnEmvgM7xNr4&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PBYIQ4TECY%2F20260311%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260311T163915Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=037b7ed5486475bcd2c0b22c494a708c758f45bfa3fc7fcfd5f97f81f28d3e6d", "filename": "408564_testing.pdf", "uploaded_by": { "id": 408564, "company_id": 10004, "name": "sunil Forwarder", "firstname": "sunil", "lastname": "Forwarder", "contact": { "email": "sunil.vootkuri@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Accountant", "Compliance Officer FWD ", "Field Agent", "MBSiQ", "Remarketing FWD", "Team Lead", "Transportation FWD", "Vendor Manager", "VendorConnect Client", "VendorConnect Service Provider" ], "self": "http://stg-api.mbsisystems.com/api/employees/408564", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 16:35:20", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-11 16:35:20", "created_at": "2026-03-11T16:35:20.000000Z" } } ], "meta": { "total": 3 } } |
Retrieve Recovery Personals
Description: This endpoint retrieves the list of personal items associated with a specific recovery record.
Personal items represent belongings found inside the recovered collateral during the recovery process. This endpoint returns details about the personal items recorded for the specified recovery, including item descriptions and related metadata.
URL: /api/v140/orders/{order_id}/recoveries/{recovery_id}/personals
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57070400/recoveries/10120180/personals |
Request Body: NA
Response:
{ "data": { "personals": 1, "personals_by": 87798, "personals_witnessed_by": 11765, "personals_spacenumber": "2", "personals_numcontainers": "12", "personals_address_id": "6075318", "personal_items": { "passengercabin": [ "papers" ], "glove": [ "Glovebox" ], "trunk": [ "Trunk" ] } } } |
Create Recovery Personals
Description: This endpoint creates a personal property record associated with a specific recovery.
During the recovery process, personal belongings found inside the recovered collateral (such as items in the trunk, glove compartment, or cabin) can be recorded. This endpoint allows users to store information about those items along with the property location and storage details.
URL: /api/v140/orders/{order_id}/recoveries/{recovery_id}/personals
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
property_location | Identifier representing where the personal property is stored | Yes | 1 |
space_number | Storage space number where the property is kept | No | 34433 |
bin_count | Number of bins used to store the personal items | No | null |
trunk | List of personal items found in the vehicle trunk | No | ["test trunk"] |
glove | List of personal items found in the glove compartment | No | ["test glove"] |
cabin | List of personal items found in the vehicle cabin | No | ["test cabin"] |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57073414/recoveries/10120407/personals |
Request Body:
{ "property_location": 1, "space_number": 34356, "bin_count": null, "trunk": [ "Mobile trunk" ], "glove": [ "Glasses glove" ], "cabin": [ "water bottle cabin" ]
} |
Response:
{ "data": { "personals": 1, "personals_by": 408564, "personals_witnessed_by": 408564, "personals_spacenumber": "34356", "personals_numcontainers": null, "personals_address_id": "1", "personal_items": { "passengercabin": [ "water bottle cabin" ], "glove": [ "Glasses glove" ], "trunk": [ "Mobile trunk" ] } } } |
Retrieve Recovery Personals Photos
Description: This endpoint retrieves the list of photos associated with personal property recorded during a recovery.
When personal belongings are found inside the recovered collateral (such as items in the trunk, glove compartment, or cabin), photos may be captured for documentation purposes. This endpoint returns the photos attached to the personal property records for the specified recovery.
URL: /api/v140/orders/{order_id}/recoveries/{recovery_id}/personals/photos
Method: GET
Request Body Parameters:
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v140/orders/57073414/recoveries/10120407/personals/photos |
Request Body: NA
Response:
{ "data": [ { "id": 180461047, "type": { "id": 20, "name": "Personal Property", "always_show": 1, "is_required": 0, "type": "documents", "created_at": "2020-01-20 15:12:16", "updated_at": "2020-06-27 06:26:39", "deleted_at": null }, "order_attachment_type_id": 20, "recovery_has_damage_type_location_id": null, "order_id": 57073414, "name": "New Picture", "photo_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/original/10004/408564/2026/03/11/Oqf82aHNBBWd/408564_name.jpg?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=20260311T171530Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=67b1794170b41570406ebdf64e5b7bcb170a88c2ed66b36bf72be6272fe8860a", "filename": "408564_name.jpg", "uploaded_by": { "id": 408564, "company_id": 10004, "name": "sunil Forwarder", "firstname": "sunil", "lastname": "Forwarder", "contact": { "email": "sunil.vootkuri@esgit.com", "mobile_phone": null }, "roles": [ "Administrator FWD", "Billing Manager", "Billing Staff ", "Billing Supervisor", "Case Worker FWD", "Accountant", "Compliance Officer FWD ", "Field Agent", "MBSiQ", "Remarketing FWD", "Team Lead", "Transportation FWD", "Vendor Manager", "VendorConnect Client", "VendorConnect Service Provider" ], "self": "http://stg-api.mbsisystems.com/api/employees/408564", "expand": "employee" }, "parent_attachment_order_id": null, "created_at": "2026-03-11 17:07:48", "meta": { "lat": "0.00000000", "long": "0.00000000", "generated_at": "2026-03-08 23:23:00", "created_at": "2026-03-11T17:07:48.000000Z" } } ], "meta": { "total": 1 } } |
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/v140/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/v140/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/v140/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/v140/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/v140/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/v140/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" } |