Applies to integrated customers using the RecoveryConnect API



Retrieve Lots for Specified Company

DescriptionThis endpoint retrieves the list of lots associated with a specific company.

Lots represent storage facilities or locations used to store recovered collateral or assets. By providing the company ID, this endpoint returns the lots configured for that company.

An optional order_id query parameter can be used to filter the lot list based on the client and lienholder RISC (Repossession Industry Standard Certification) settings. If the client or lienholder requires RISC-enabled lots, only those lots with a valid future RISC expiration date will be returned.

URL: /api/v150/companies/{company_id}/lots
Method: GET

Query Parameters:

PARAMETER

DESCRIPTION

MANDATORY

EXAMPLE

order_id


 

Filters the lot list based on the client and lienholder RISC requirements associated with the specified order. If RISC is enabled, only lots with a valid future RISC expiration date will be returned.

No

?order_id=57070537

 

Request Body Parameters: NA

Success Code: 200 OK – Request Successful

Example:

URL: https://api.mbsisystems.com/api/v150/companies/127562/lots

 

Request Body: NA

Response:

{

    "data": [

        {

            "id": 127705,

            "address_id": 1595372,

            "company_id": 127562,

            "is_primary": 1,

            "is_cars_certified": 1,

            "is_risc_certified": 0,

            "risc_lot_expiration": null,

            "risc_inspection_id": null,

            "risc_certification_date": null,

            "irepo_lot_id": null,

            "irepo_branch_id": null,

            "address_details": {

                "id": 1595372,

                "name": "MAIN",

                "address_1": "2281 Kurtis Island Apt. 931",

                "address_2": "",

                "state_abbr": "MI",

                "city_name": "Middleville",

                "zip_code": "49333",

                "county_name": "Barry",

                "longitude": null,

                "latitude": null,

                "unit": null,

                "phones": [

                    {

                        "id": 752643,

                        "type": 2,

                        "number": "619-239-5607",

                        "extension": null

                    },

                    {

                        "id": 752644,

                        "type": 4,

                        "number": "",

                        "extension": null

                    },

                    {

                        "id": 752645,

                        "type": 3,

                        "number": "",

                        "extension": null

                    }

                ]

            }

        }

    ],

    "warnings": []

}

 

 

Retrieve DNU Agents for Company

DescriptionThis endpoint retrieves the Do Not Use (DNU) agents configured for a specific company.

DNU agents represent individuals or entities that are restricted from being assigned work or tasks for the company. These listings help ensure that assignments are not allocated to agents who have been flagged or restricted due to operational, compliance, or business reasons.

By providing the company ID, this endpoint returns all DNU agent records associated with that company.

URL: /api/v150/companies/{company_id}/DNU_agents
Method: GET

Request Body Parameters: NA

Success Code: 200 OK – Request Successful

Example:

URL: https://api.mbsisystems.com/api/v150/companies/180276/DNU_agents

 

Request Body: NA

Response:

{

    "data": [

        {

            "id": 6945,

            "blacklisted_company_id": 73200,

            "blacklisted_company": {

                "id": 73200,

                "name": "Hobbs Recovery",

                "type": 3,

                "updated_at": "2022-10-27 21:55:37",

                "addresses": [

                    {

                        "id": 63271,

                        "address_id": 349638,

                        "company_id": 73200,

                        "is_primary": 1,

                        "is_cars_certified": 1,

                        "is_risc_certified": 0,

                        "risc_lot_expiration": null,

                        "risc_inspection_id": null,

                        "risc_certification_date": null,

                        "irepo_lot_id": null,

                        "irepo_branch_id": null,

                        "address_details": {

                            "id": 349638,

                            "name": "main",

                            "address_1": "647 Schinner Ports",

                            "address_2": "",

                            "state_abbr": "FL",

                            "city_name": "Pensacola",

                            "zip_code": "32534",

                            "county_name": "Escambia",

                            "longitude": "-87.27164500",

                            "latitude": "30.52975500",

                            "unit": null,

                            "phones": [

                                {

                                    "id": 265120,

                                    "type": 2,

                                    "number": "505-902-4201",

                                    "extension": null

                                },

                                {

                                    "id": 265121,

                                    "type": 4,

                                    "number": "716-653-8419",

                                    "extension": null

                                },

                                {

                                    "id": 265122,

                                    "type": 3,

                                    "number": "",

                                    "extension": null

                                }

                            ]

                        }

                    },

                    {

                        "id": 70918,

                        "address_id": 868272,

                        "company_id": 73200,

                        "is_primary": 0,

                        "is_cars_certified": 1,

                        "is_risc_certified": 0,

                        "risc_lot_expiration": null,

                        "risc_inspection_id": null,

                        "risc_certification_date": null,

                        "irepo_lot_id": null,

                        "irepo_branch_id": null,

                        "address_details": {

                            "id": 868272,

                            "name": "Hobbs Recovery",

                            "address_1": "410 Lura Stream Apt. 602",

                            "address_2": "",

                            "state_abbr": "FL",

                            "city_name": "Pensacola",

                            "zip_code": "32534",

                            "county_name": "Escambia",

                            "longitude": "-87.23991800",

                            "latitude": "30.43925500",

                            "unit": null,

                            "phones": [

                                {

                                    "id": 449012,

                                    "type": 2,

                                    "number": "",

                                    "extension": null

                                },

                                {

                                    "id": 449014,

                                    "type": 4,

                                    "number": "",

                                    "extension": null

                                },

                                {

                                    "id": 449016,

                                    "type": 3,

                                    "number": "",

                                    "extension": null

                                }

                            ]

                        }

                    }

                ]

            },

            "employee_id": 424549,

            "blacklisted_for_company": 180276,

            "reason": "Reason",

            "created_at": "2026-03-12 10:29:39",

            "updated_at": "2026-03-12 10:29:39"

        }

    ]

}

 

Retrieve Company Employees

DescriptionThis endpoint retrieves the list of active employees associated with a specified company.

The requesting user's company and the specified company must have an existing company connection established in order to access the employee records. Only active employees for the specified company will be returned.

Pagination parameters can be used to control the number of records returned per request.

 

URL: /api/v150/companies/{company_id}/employees
Method: GET

Query Parameters:

PARAMETER

DESCRIPTION

MANDATORY

EXAMPLE

per_page

Number of records returned per page. Default is 1000, maximum allowed is 5000

No

?per_page=500

page


 

Specifies the page number of the results to retrieve

No

?page=1

 

Request Body Parameters: NA

Success Code: 200 OK – Request Successful

Example:

URL: https://api.mbsisystems.com/api/v150/companies/10004/employees?&per_page=4

 

Request Body: NA

Response:

{

    "data": [

        {

            "id": 11765,

            "company_id": 10004,

            "name": "Forwarding Office",

            "firstname": "Forwarding",

            "lastname": "Office",

            "contact": {

                "email": null,

                "mobile_phone": null

            },

            "roles": [

                "Administrator FWD",

                "API Connection",

                "Accountant",

                "Case Worker FWD",

                "Compliance Officer FWD ",

                "Field Agent",

                "Remarketing FWD",

                "Team Lead",

                "Transportation FWD",

                "Accountant",

                "Administrator FWD",

                "Field Agent"

            ],

            "self": "http://stg-api.mbsisystems.com/api/employees/11765",

            "expand": "employee"

        },

        {

            "id": 78830,

            "company_id": 10004,

            "name": "William Sheehan",

            "firstname": "William",

            "lastname": "Sheehan",

            "contact": {

                "email": "wmjsiv@ciber.demo",

                "mobile_phone": null

            },

            "roles": [

                "Administrator FWD"

            ],

            "self": "http://stg-api.mbsisystems.com/api/employees/78830",

            "expand": "employee"

        },

        {

            "id": 80034,

            "company_id": 10004,

            "name": "Erika Clark",

            "firstname": "Erika",

            "lastname": "Clark",

            "contact": {

                "email": "eclark@kciber.demo",

                "mobile_phone": null

            },

            "roles": [

                "Case Worker FWD"

            ],

            "self": "http://stg-api.mbsisystems.com/api/employees/80034",

            "expand": "employee"

        },

        {

            "id": 80077,

            "company_id": 10004,

            "name": "Servicing Solution",

            "firstname": "Servicing",

            "lastname": "Solution",

            "contact": {

                "email": "",

                "mobile_phone": null

            },

            "roles": [

                "Administrator FWD"

            ],

            "self": "http://stg-api.mbsisystems.com/api/employees/80077",

            "expand": "employee"

        }

    ],

    "links": {

        "first": "http://stg-api.mbsisystems.com/api/v140/companies/10004/employees?page=1",

        "last": "http://stg-api.mbsisystems.com/api/v140/companies/10004/employees?page=183",

        "prev": null,

        "next": "http://stg-api.mbsisystems.com/api/v140/companies/10004/employees?page=2"

    },

    "meta": {

        "current_page": 1,

        "from": 1,

        "last_page": 183,

        "path": "http://stg-api.mbsisystems.com/api/v140/companies/10004/employees",

        "per_page": 4,

        "to": 4,

        "total": 732

    }

}