Applies to integrated customers using the RecoveryConnect API



Orders Operations

The Order Operations section contains endpoints for creating, retrieving, updating, assigning, and managing orders (cases) in the system. These endpoints allow users to manage order details, employees assigned to orders, addresses, tags, attachments, and related order information.

All requests must include a valid Bearer Token in the request header.

 

Retrieve Order Client Details


Description: This endpoint retrieves the client information associated with a specific order (case). It returns the client details linked to the provided order ID.

URL: /api/v130/orders/{order_id}/client
Method: GET
 
Request Body Parameters: NA
 Success Code: 
200 OK – Request Successful

Example:

https://api.mbsisystems.com/api/v130/orders/57066438/client


Request Body: NA
Response:

{

    "data": [

        {

            "id": 65690,

            "district_id": null,

            "parent_company": null,

            "type": 11,

            "status": 1,

            "created_by": 10001,

            "created_by_employee": 10013,

            "merged_from": null,

            "owned_by": 3099,

            "name": "Demo Bank & Trust MRS",

            "legal_name": "Demo Bank and Trust",

            "website": "",

            "is_global": 2,

            "tin": "123",

            "current_caseno": 10431,

            "current_transid": 70112,

            "signup_code": 0,

            "htmlhead": null,

            "allow_provider_change": 1,

            "allow_client_personal_items": 1,

            "allow_bk_scrub": 1,

            "allow_ssn_hide": 1,

            "auto_purchase_plates": 0,

            "lienholder_verification": 1,

            "ssn_digits": 4,

            "password_expiration": 0,

            "password_expiration_days": 0,

            "previous_passwords": 0,

            "previous_passwords_number": 0,

            "allow_cln_hide": 0,

            "cln_digits": 8,

            "scorecard_enabled": 1,

            "scorecard_enabled_at": "2020-06-23 16:39:17",

            "login_type": null,

            "service_provider_custom_fees": 0,

            "allow_sp_add": 1,

            "auto_sp_add": 0,

            "store_number": "5678",

            "disable_adding_ssn": 0,

            "disable_adding_loan_payment": 0,

            "service_provider_allow_sp_add": 1,

            "only_approved_invoiceprint": 0,

            "parent_approval_invoice_exp": 0,

            "address_is_public_by_default": 1,

            "preferred_billing": "ACH Deposit",

            "invoices_created_due_after": 30,

            "recovery_acknowledgement_lockout": null,

            "company_wide_hold": 0,

            "auto_ack_plate_share_web": 0,

            "filter_sp_by_cvt": 1,

            "fieldvisit_ackn": 0,

            "repo_ackn": 0,

            "bulk_recharge": 1,

            "use_company_email": 1,

            "validate_case_import_vin": 0,

            "search_data_staging_member_companies": 0,

            "charge_transaction_fees": 1,

            "geo_assignment_restriction": 0,

            "created_at": "2015-04-08 22:23:30",

            "updated_at": "2026-03-05 12:27:54",

            "deleted_at": null,

            "manual_contract": 1,

            "client_invoicing_requirements": 1,

            "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": 1,

            "bill_to_debtor_days": "45",

            "sla_enforced": 0,

            "sla_enforced_days": "0",

            "sla_allowed_invoice": "0",

            "gl_code_require": 0,

            "phones": []

        }

    ],

    "meta": {

        "fixme": {

            "message": "GenericResource: create specific resource object",

            "source": {

                "file": "/var/www/mobile_dev/releases/20210210171746/versions/v140/app/Http/Controllers/Api/Mixins/Actions/Get/ShowSingleCompanyOrder.php",

                "line": 34,

                "function": "__construct",

                "class": "App\\Http\\Resources\\GenericResource",

                "type": "->"

            }

        }

    }

}

 

Retrieve Recon Assignments – Filtering endpoint

 
Description: This endpoint retrieves assignments with limited parameters. It allows filtering assignment records using query parameters such as status, client ID, account number, and assignment IDs. The endpoint also supports pagination.

URL: /api/v130/recon/assignments
Method: GET

Query Parameters:

PARAMETER

DESCRIPTION

EXAMPLE

status

Filters orders by collateral status ID

1

acct_no

Filters orders by client account number

122121

client_id

Filters orders by client identifier

65690

owner_id

Filters orders by the owner company ID

10001

ids

Filters assignments by specific assignment IDs (comma-separated list)

109773,109774

per_page

Number of records per page. Default value is 250

100

page

Specifies the page number for paginated results

2


 
Request Body Parameters: NA
 Success Code: 
200 OK – Request Successful

Example:

URL: https://api.mbsisystems.com/api/v130/recon/assignments?client_id=65690&status=1


 
Request Body: NA
Response:

{

    "data": [

        {

            "id": 30554,

            "other_refno": null,

            "client_id": 65690,

            "lienholder": null,

            "status_date": null,

            "accepted_date": null,

            "tier_level": null,

            "placement_level": null,

            "created_at": "2016-02-26 18:32:33",

            "company_orderno": "1031-1",

            "order_type": 1,

            "status": 1,

            "vin": null,

            "borrower_firstname": null,

            "borrower_middle_initial": null,

            "borrower_lastname": null,

            "mass_hold_tags": [],

            "violent_event_details": []

        }

    ],

    "links": {

        "first": "http://stg-api.mbsisystems.com/api/v140/recon/assignments?q=%2Fapi%2Fv140%2Frecon%2Fassignments&client_id=65690&status=1&page=1",

        "last": "http://stg-api.mbsisystems.com/api/v140/recon/assignments?q=%2Fapi%2Fv140%2Frecon%2Fassignments&client_id=65690&status=1&page=1",

        "prev": null,

        "next": null

    },

    "meta": {

        "current_page": 1,

        "from": 1,

        "last_page": 1,

        "path": "http://stg-api.mbsisystems.com/api/v140/recon/assignments",

        "per_page": "20",

        "to": 1,

        "total": 1,

        "orderby": "id",

        "direction": "asc",

        "orderby_options": [

            "id"

        ]

    },

    "warnings": []

}

 

Add Office Employee to Order

 
Description: This endpoint assigns one or more office employees to a specific order.

URL: /api/v130/orders/{order_id}/office_employees
Method: POST
 
Request Body Parameters:

PARAMETER

DESCRIPTION

MANDATORY

EXAMPLE

employee_ids

An array containing the employee IDs to be assigned to the order

Yes

131709


 Success Code: 
200 OK – Request Successful

Example:

URL: https://api.mbsisystems.com/api/v130/orders/57070212/office_employees


 
Request Body:

{

  "employee_ids": [

    78830, 80034

  ]

}


Response:

{

    "data": [

        {

            "id": 124941377,

            "order_id": 57070212,

            "employee_id": 78830,

            "person_id": 1971583,

            "firstname": "William",

            "middlename": null,

            "lastname": "Sheehan",

            "role": null,

            "is_violent": 0,

            "is_primary": 0

        },

        {

            "id": 124941378,

            "order_id": 57070212,

            "employee_id": 80034,

            "person_id": 2046199,

            "firstname": "Erika",

            "middlename": null,

            "lastname": "Clark",

            "role": null,

            "is_violent": 0,

            "is_primary": 0

        }

    ],

    "status": "success"

}