Applies to integrated customers using the RecoveryConnect APICollateral Operations
The Collateral Operations section contains endpoints used to retrieve, create, update, and manage collateral records associated with an order. Collateral represents the asset (typically a vehicle or equipment) tied to the recovery case.
These endpoints allow users to manage collateral information and track collateral location history.
All requests must include a valid Bearer token in the request header.
Retrieve Collateral Location Records
Description: Retrieves all location records associated with a specific collateral within an order.
URL: /api/v130/orders/{order_id}/collaterals/{collateral_id}/locations
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v130/orders/57070279/collaterals/58850064/locations |
Request Body: NA
Response:
{ "data": [ { "loc_type": "Stored", "notes": null, "created_at": "2026-03-02 10:59:56", "updated_at": "2026-03-02 10:59:56", "location_date": "2026-03-02 10:59:00", "recovery": { "id": 10120168, "order_id": 57070279, "parent_id": null, "order_collaterals_id": 58850064, "color_id": 1, "damage_code": 6, "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": 1, "created_at": "2026-03-02 10:59:56", "deleted_at": null, "is_active": "1", "updated_at": "2026-03-02 11:10:48", "collateral_miles": 1000, "drivable": "No", "keys": "No", "keys_cut": 0, "recovery_police_badge": "", "recovery_police_notified_date": "2026-03-02 10:59:00", "client_estimated_fee": "20.00", "client_notes": "Automation Test", "recovery_date": "2026-03-02 10:59:00", "added_by": 87798, "lpnum": null, "lpstate": null, "lpexpire": null, "personals": 1, "personals_by": 87798, "personals_witnessed_by": 11765, "personals_spacenumber": "2", "personals_numcontainers": "12", "personals_completed": 1, "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": "5 days", "personal_items": { "passengercabin": [ "papers" ], "glove": [ "Glovebox" ], "trunk": [ "Car Seat" ] }, "recovered_by": [ { "id": 93200021, "recovery_id": 10120168, "employees_id": 188832, "created_at": "2026-03-02 10:59:56", "deleted_at": null, "company_id": 180338 } ], "recovery_assignment_id": null, "damage_locations": [ { "id": 10036255, "recovery_id": 10120168, "damage_type_location_id": 45, "damage_type_id": 7, "created_at": "2026-03-02 11:00:01", "updated_at": "2026-03-02 11:00:01" } ], "personals_address_id": "6076174", "lpr_recovery": 0, "client_id": 65690, "client_name": "Demo Bank & Trust MRS", "company_orderno": 103097, "vin": "2C3CDXHG7FH777831", "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": 49171, "order_id": 57070279, "recovery_id": 10120168, "service_provider_id": 180338, "address_id": 6076174, "created_at": "2026-03-02 10:59:56", "updated_at": "2026-03-02 10:59:56" } }, "address": { "id": 6076174, "name": "Shawn's Test Lot - 2307", "address_1": "2369 Mueller Center Apt. 876", "address_2": "", "state_abbr": "AZ", "city_name": "Phoenix", "zip_code": "85021", "county_name": "Maricopa", "longitude": "-112.10837180", "latitude": "33.56568520", "unit": null } }, { "loc_type": "Recovered", "notes": null, "created_at": "2026-03-02 10:59:56", "updated_at": "2026-03-02 10:59:56", "location_date": "2026-03-02 10:59:00", "recovery": { "id": 10120168, "order_id": 57070279, "parent_id": null, "order_collaterals_id": 58850064, "color_id": 1, "damage_code": 6, "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": 1, "created_at": "2026-03-02 10:59:56", "deleted_at": null, "is_active": "1", "updated_at": "2026-03-02 11:10:48", "collateral_miles": 1000, "drivable": "No", "keys": "No", "keys_cut": 0, "recovery_police_badge": "", "recovery_police_notified_date": "2026-03-02 10:59:00", "client_estimated_fee": "20.00", "client_notes": "Automation Test", "recovery_date": "2026-03-02 10:59:00", "added_by": 87798, "lpnum": null, "lpstate": null, "lpexpire": null, "personals": 1, "personals_by": 87798, "personals_witnessed_by": 11765, "personals_spacenumber": "2", "personals_numcontainers": "12", "personals_completed": 1, "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": "5 days", "personal_items": { "passengercabin": [ "papers" ], "glove": [ "Glovebox" ], "trunk": [ "Car Seat" ] }, "recovered_by": [ { "id": 93200021, "recovery_id": 10120168, "employees_id": 188832, "created_at": "2026-03-02 10:59:56", "deleted_at": null, "company_id": 180338 } ], "parent": null, "police_agency": { "id": 10778, "district_id": null, "parent_company": null, "type": 9, "status": 1, "created_by": 10000, "created_by_employee": 10000, "merged_from": null, "owned_by": 131083128, "name": "105 New York Police Department", "legal_name": null, "website": "http://police.gov", "is_global": 1, "tin": null, "current_caseno": 0, "current_transid": 70, "signup_code": 0, "htmlhead": null, "allow_provider_change": 1, "allow_client_personal_items": 1, "allow_bk_scrub": 0, "allow_ssn_hide": null, "auto_purchase_plates": 0, "lienholder_verification": 0, "ssn_digits": null, "password_expiration": 0, "password_expiration_days": 180, "previous_passwords": 0, "previous_passwords_number": 2, "allow_cln_hide": null, "cln_digits": null, "scorecard_enabled": 0, "scorecard_enabled_at": null, "login_type": null, "service_provider_custom_fees": 0, "allow_sp_add": 1, "auto_sp_add": 0, "store_number": null, "disable_adding_ssn": 0, "disable_adding_loan_payment": 0, "service_provider_allow_sp_add": 0, "only_approved_invoiceprint": 0, "parent_approval_invoice_exp": 0, "address_is_public_by_default": 1, "preferred_billing": "Credit Card", "invoices_created_due_after": 30, "recovery_acknowledgement_lockout": null, "company_wide_hold": 0, "auto_ack_plate_share_web": 0, "filter_sp_by_cvt": 0, "fieldvisit_ackn": 1, "repo_ackn": 1, "bulk_recharge": 1, "use_company_email": 1, "validate_case_import_vin": 0, "search_data_staging_member_companies": 0, "charge_transaction_fees": null, "geo_assignment_restriction": 0, "created_at": "2014-06-21 07:05:45", "updated_at": "2023-04-10 16:38:30", "deleted_at": null, "manual_contract": 0, "client_invoicing_requirements": 0, "deliver_to_auction": 0, "release_to_auction": 0, "donot_contact_flag": 0, "enable_contracted_fees": null, "allow_vin_hide": null, "vin_digits": null, "has_claims": 0, "pre_approved_auto_invoice": 1, "bill_to_debtor": 0, "bill_to_debtor_days": null, "sla_enforced": 0, "sla_enforced_days": null, "sla_allowed_invoice": null, "gl_code_require": 0, "main_company_address": { "id": 778, "address_id": 778, "company_id": 10778, "invoice_daily_target_amount": "0.00", "recovery_daily_target": "0.00", "is_primary": 1, "is_cars_certified": 1, "created_at": "2014-06-21 07:05:46", "updated_at": "2014-06-21 07:05:46", "is_risc_certified": 0, "risc_lot_expiration": null, "deleted_at": null, "risc_inspection_id": null, "risc_certification_date": null, "address_details": { "id": 778, "name": null, "address_1": "7660 Elias Mews Suite 266", "address_2": "", "unit": null, "zip": 10, "type": 1, "latitude": "47.26394272", "longitude": "11.15739536", "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2014-06-21 07:05:46", "updated_at": "2023-09-29 06:30:30", "deleted_at": null, "migration": 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 } } ], "zip_code_details": { "zip_code_id": 10, "zip_code": "00000", "zip_code_city_id": 10, "city_name": "Unknown", "zip_code_state_id": 10, "state_name": "Unknown", "state_abbr": "NA", "state_county": "ZZ-Unknown", "zip_code_county_id": 10, "county_name": "Unknown", "latitude": "0.000000", "longitude": "0.000000", "system_msg": 0, "country": "Unknown", "country_code": "ZZ", "trigger_msg": 0, "shape_data": null } } } }, "recovery_assignment_id": null, "damage_locations": [ { "id": 10036255, "recovery_id": 10120168, "damage_type_location_id": 45, "damage_type_id": 7, "created_at": "2026-03-02 11:00:01", "updated_at": "2026-03-02 11:00:01" } ], "personals_address_id": "6076174", "lpr_recovery": 0, "client_id": 65690, "client_name": "Demo Bank & Trust MRS", "company_orderno": 103097, "vin": "2C3CDXHG7FH777831", "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": 49171, "order_id": 57070279, "recovery_id": 10120168, "service_provider_id": 180338, "address_id": 6076174, "created_at": "2026-03-02 10:59:56", "updated_at": "2026-03-02 10:59:56" } }, "address": { "id": 120092338, "name": "Home Address", "address_1": "A_Raeann2384 E Browning Pl Chandler", "address_2": "", "state_abbr": "AZ", "city_name": "Phoenix", "zip_code": "85001", "county_name": "Maricopa", "longitude": "0.00000000", "latitude": "0.00000000", "unit": "" } } ] } |