Applies to integrated customers using the RecoveryConnect APICreate Collateral Location
Description: This endpoint is used to create a location event for a specific collateral within an order.
It records actions related to the authorization, transport, or redemption of the collateral.
Depending on the loc_type, the request body parameters may vary. Some parameters are common across all location events, while others are specific to redemption or transport workflows.
Typical use cases include:
- Authorizing redemption of collateral
- Authorizing transport of collateral
- Recording completed transport
- Recording completed redemption (release)
All requests must include a valid Bearer Token in the request header.
URL: /api/v130/orders/{order_id}/collaterals/{collateral_id}/locations
Method: POST
Request Body Parameters:
Common Parameters
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
loc_type | Defines the type of collateral location event (authorization, transport, or release). Refer to Location Type Values below | Yes | Transported |
location_date | Date and time when the location event occurred | Yes | 2026-01-17 07:59:00 |
addresses_id | Unique identifier of the address where the collateral is located or being transported to | Yes | 262552 |
notes | Additional remarks or comments related to the collateral location event | No | Transport initiated by logistics team |
notification_email | List of email addresses to notify regarding the collateral movement or authorization | No | ["xyca123@gmail.com "] |
transport_company_id | Company ID of the transport company responsible for moving the collateral | Yes | 140702 |
Redemption Specific Parameters:
These parameters are used during the redemption (release) workflow.
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
release_to | Identifier of the person or entity to whom the collateral is released (borrower id) | Yes | 136702306 |
delivery_required | Indicates whether delivery of the collateral is required (0 = No, 1 = Yes) | Yes | 0 |
Transport Specific Parameters
These parameters apply to transport-related events.
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
destination_company_id | Company receiving the collateral (auction company id) | Yes | 191368 |
transport_company_id | The company responsible for transporting the collateral (transport company id) | Yes | 140702 |
Location Type Values
Location Type | Description |
Complete Auth and Release | Authorization completed and collateral released to the recipient. |
Complete Auth and Transport | Authorization completed and collateral transported. |
Authorized to Release | Indicates partial authorization has been granted to release the collateral, but the release has not yet been completed. |
Authorized to Transport | Indicates partial authorization has been granted to transport the collateral, but the transport has not yet been completed. |
Transported | Indicates that the collateral has been successfully transported to the destination. This action can only be recorded after Authorized to Transport has been performed. |
Released | Indicates that the collateral has been fully released as part of the redemption process. This action can only be recorded after the Authorized to Release has been performed. |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v130/orders/57062885/collaterals/58842868/locations |
Request Body:
{ "addresses_id": 120092338, "loc_type": "Complete Auth and Transport", "destination_company_id": 191368, "location_date": "2026-01-17 07:59:00", "transport_company_id": 140702, "notification_email":[ "vinay.band@esgit.com"], "notes": "vinay is testing" } |
Response:
{ "data": [ { "id": 105735175, "parent_id": null, "recovery_id": 10119986, "order_collateral_id": 58842868, "addresses_id": 66391424, "address_id_by": 2589556, "collateral_release_id": null, "collateral_status": null, "to_obj": 0, "lotnum": null, "added_by": 408564, "loc_type": "Authorized to Transport", "notes": "vinay is testing", "object_by": "Company", "object_id_by": 140702, "object": "Company", "object_id": 191368, "changes_location": 0, "sync_to_mmi": null, "delivery_required": null, "location_date": "2026-01-17T07:59:00.000000Z", "other_hold_type_id": null, "created_at": "2026-03-07 11:09:35", "updated_at": "2026-03-07 11:09:35", "recovery": { "id": 10119986, "order_id": 57062885, "parent_id": 10119985, "order_collaterals_id": 58842868, "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-02-17 10:48:34", "deleted_at": null, "is_active": "1", "updated_at": "2026-02-17 10:48:39", "collateral_miles": 1000, "drivable": "Yes", "keys": "No", "keys_cut": 0, "recovery_police_badge": "", "recovery_police_notified_date": "2026-02-17 10:47:00", "client_estimated_fee": "20.00", "client_notes": "Automation Test", "recovery_date": "2026-02-17 10:47:00", "added_by": 119399, "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": "19 days", "personal_items": { "passengercabin": [], "glove": [], "trunk": [] }, "recovered_by": [ { "id": 93199819, "recovery_id": 10119986, "employees_id": 119399, "created_at": "2026-02-17 10:48:34", "deleted_at": null, "company_id": 10001 } ], "recovery_assignment_id": 57062886, "damage_locations": [], "personals_address_id": 0, "lpr_recovery": 0, "client_id": 65690, "client_name": "Demo Bank & Trust MRS", "company_orderno": 102930, "vin": "1GCEK19B75Z271554", "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": null }, "address": { "id": 66391424, "name": null, "address_1": "2301 W Dunlap ave", "address_2": null, "state_abbr": "AZ", "city_name": "Phoenix", "zip_code": "85021", "county_name": "Maricopa", "longitude": "-112.10865000", "latitude": "33.56673800", "unit": null } } ] } |