Applies to integrated customers using the RecoveryConnect API
Smart Invoice Fee Requests Operations
The Smart Invoice Fee Requests section provides endpoints used to manage fee requests associated with orders. These endpoints allow users to retrieve, create, update, and delete fee requests, which are typically used before generating invoices.
All requests must include a valid Bearer token in the request header.
Get Billable Fee Requests
Description: This endpoint retrieves the contract details and billable fee requests associated with a specific order.
Billable fee requests represent requested charges that are pending approval or processing before being invoiced. These requests are typically created as part of the billing workflow and may later be converted into pre-invoice fees or invoices.
The response includes both the applicable contract details and the list of billable fee requests for the specified order.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/billable_fee_requests
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57074785/billable_fee_requests |
Request Body: NA
Response:
{ "data": { "contract_id": 302, "version_number": "1.7", "items": [ { "item_id": 1018863, "master_id": 1499, "default_amount": 0, "description": "Advanced Funds" }, { "item_id": 1018864, "master_id": 1515, "default_amount": 125, "description": "Deliver to Auction " }, { "item_id": 1018865, "master_id": 1505, "default_amount": 50, "description": "Close Continental US" }, { "item_id": 1018866, "master_id": 1505, "default_amount": 50, "description": "Dual Assignment Close Fee " }, { "item_id": 1018867, "master_id": 1505, "default_amount": 250, "description": "Close Fee Alaska" }, { "item_id": 1018868, "master_id": 1505, "default_amount": 250, "description": "Close Fee Hawaii" }, { "item_id": 1018869, "master_id": 1659, "default_amount": 75, "description": "Collateral Redemption Reinstatement Fee" }, { "item_id": 1018870, "master_id": 1512, "default_amount": 150, "description": "Condition Report and Pics" }, { "item_id": 1018871, "master_id": 3877, "default_amount": 0, "description": "County Clerk fee (LA only)" }, { "item_id": 1018872, "master_id": 3877, "default_amount": 0, "description": "Dolly Tow" }, { "item_id": 1018873, "master_id": 8098, "default_amount": 0, "description": "Flat Bed Fee" }, { "item_id": 1018874, "master_id": 3877, "default_amount": 15, "description": "Illinois Recovery Ticket Fee" }, { "item_id": 1018875, "master_id": 3875, "default_amount": 85, "description": "Keys - Standard" }, { "item_id": 1018876, "master_id": 3875, "default_amount": 175, "description": "Keys - Transponder" }, { "item_id": 1018877, "master_id": 3875, "default_amount": 0, "description": "Keys-Specialty" }, { "item_id": 1018878, "master_id": 3877, "default_amount": 0, "description": "LA-Filing of Official Fee" }, { "item_id": 1018879, "master_id": 3877, "default_amount": 0, "description": "LA-Recorder of Mortgage Fee" }, { "item_id": 1018880, "master_id": 3877, "default_amount": 0, "description": "Louisiana Self Help Fees" }, { "item_id": 1018881, "master_id": 1506, "default_amount": 0, "description": "Mileage" }, { "item_id": 1018882, "master_id": 1510, "default_amount": 50, "description": "Personal Property Storage Fee" }, { "item_id": 1018883, "master_id": 3877, "default_amount": 0, "description": "Reservation Repo Fee" }, { "item_id": 1018884, "master_id": 1505, "default_amount": 250, "description": "Reservation Close" }, { "item_id": 1018885, "master_id": 1659, "default_amount": 190, "description": "Return Unit (To Customer)" }, { "item_id": 1018886, "master_id": 1505, "default_amount": 100, "description": "Skip Close" }, { "item_id": 1018887, "master_id": 1502, "default_amount": 0, "description": "Skip Trace & Locate Only " }, { "item_id": 1018888, "master_id": 3877, "default_amount": 100, "description": "Stake Out" }, { "item_id": 1018889, "master_id": 1515, "default_amount": 0, "description": "Transport" }, { "item_id": 1018890, "master_id": 1504, "default_amount": 0, "description": "Vehicle Storage" }, { "item_id": 1018892, "master_id": 311041, "default_amount": 0, "description": "Privacy Data Removal" } ] } } |
Get Fee Requests
Description: This endpoint retrieves fee request records based on the provided filters.
Fee requests represent charges requested for an order prior to invoicing, typically used in the billing workflow before being converted into pre-invoice fees or invoices.
At least one of the following filters is required to retrieve records:
- orders_id
- updated_at_from
- updated_at_to
Additional filters can be applied to refine the results.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/fee_requests
Method: GET
Query Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
orders_id | Filters records by the specific order ID | No* | ?orders_id=57070537 |
approval_status | Filters results based on the approval status of the fee request | No | ?approval_status=approved |
updated_at_from | Filters records updated from the specified date | No* | ?updated_at_from=2026-01-01 |
updated_at_to | Filters records updated up to the specified date | No* | ?updated_at_to=2026-01-31 |
* Note: At least one of orders_id, updated_at_from, or updated_at_to must be provided.
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/fee_requests?updated_at_from=2026-01-01&updated_at_to=2026-01-10 |
Request Body: NA
Response:
{ "data": [ { "id": 7507510, "order_id": 57036454, "item_id": 1018863, "master_id": 1499, "gross_amount": "100.00", "tax_amount": "0.00", "net_amount": "100.00", "notes": "", "approval_status": "Requested", "created_at": "2026-01-06 02:40:50", "updated_at": "2026-01-06 02:40:50", "description": "Advanced Funds" }, { "id": 7507445, "order_id": 57035255, "item_id": 1018863, "master_id": 1499, "gross_amount": "100.00", "tax_amount": "0.00", "net_amount": "100.00", "notes": "", "approval_status": "Requested", "created_at": "2026-01-05 02:40:00", "updated_at": "2026-01-05 02:40:00", "description": "Advanced Funds" }, { "id": 7507423, "order_id": 57034406, "item_id": 1018863, "master_id": 1499, "gross_amount": "100.00", "tax_amount": "0.00", "net_amount": "100.00", "notes": "", "approval_status": "Requested", "created_at": "2026-01-04 02:39:14", "updated_at": "2026-01-04 02:39:14", "description": "Advanced Funds" }, { "id": 7507373, "order_id": 57033180, "item_id": 1018863, "master_id": 1499, "gross_amount": "100.00", "tax_amount": "0.00", "net_amount": "100.00", "notes": "", "approval_status": "Requested", "created_at": "2026-01-02 02:47:05", "updated_at": "2026-01-02 02:47:05", "description": "Advanced Funds" }, { "id": 7507352, "order_id": 57032409, "item_id": 1018863, "master_id": 1499, "gross_amount": "100.00", "tax_amount": "0.00", "net_amount": "100.00", "notes": "", "approval_status": "Requested", "created_at": "2026-01-01 02:46:51", "updated_at": "2026-01-01 02:46:51", "description": "Advanced Funds" } ], "links": { "first": "http://stg-api.mbsisystems.com/api/v2026/system/fee_requests?q=%2Fapi%2Fv150%2Ffee_requests&updated_at_from=2026-01-01&updated_at_to=2026-01-10&page=1", "last": "http://stg-api.mbsisystems.com/api/v2026/system/fee_requests?q=%2Fapi%2Fv150%2Ffee_requests&updated_at_from=2026-01-01&updated_at_to=2026-01-10&page=1", "prev": null, "next": null }, "meta": { "current_page": 1, "from": 1, "last_page": 1, "path": "http://stg-api.mbsisystems.com/api/v2026/system/fee_requests", "per_page": "250", "to": 5, "total": 5 } } |
Create Fee Request
Description: This endpoint creates a fee request for a specific order.
Fee requests represent charges requested for an order prior to invoicing and are typically part of the billing workflow. These requests may later be reviewed, approved, and converted into pre-invoice fees or invoices.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/order_id/fee_requests
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
item_id | Identifier of the fee item associated with the order contract | Yes | 1000516 |
amount | Monetary amount requested for the fee | Yes | 125.05 |
notes
| Optional notes or comments related to the fee request | No | test note |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57074785/fee_requests |
Request Body:
{ "item_id": 1000516, "amount": 125.05, "notes": "test note" } |
Response:
{ "data": { "id": 917693, "order_id": 2652260, "item_id": 1001412, "gross_amount": 125, "tax_amount": 0, "net_amount": 125, "notes": "test note", "approval_status": "Approved", "created_at": "2022-02-08 16:08:45", "updated_at": "2022-02-08 16:08:45", "description": "Advance Funds" } } |
Update Fee Request
Description: This endpoint updates an existing fee request associated with a specific order.
Fee requests represent charges requested prior to invoicing. This endpoint allows updating financial details such as the item cost, tax amount, and remarks before the fee request is approved or processed further in the billing workflow.
Only the fields included in the request body will be updated. Fields not provided will remain unchanged.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/order_id/fee_requests/{fee_request_id}
Method: PUT
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
itemCost | Updated cost of the fee item | No | 125.05 |
itemTaxAmount | Updated tax amount applied to the fee | No | 5.05 |
itemRemarks | Updated remarks or notes for the fee request | No | test note |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57074785/fee_requests/7507510 |
Request Body:
{ "item_id": 1000516, "amount": 125.05, "notes": "test note" } |
Response:
{ "data": { "id": 917693, "order_id": 2652260, "item_id": 1001412, "gross_amount": 125, "tax_amount": 0, "net_amount": 125, "notes": "test note", "approval_status": "Approved", "created_at": "2026-02-08 16:08:45", "updated_at": "2026-02-08 16:08:45", "description": "Advance Funds" } } |
Delete Fee Request
Description: This endpoint deletes an existing fee request associated with a specific order.
Fee requests represent charges requested prior to invoicing. This endpoint allows removal of a fee request that is no longer required or was created incorrectly, provided it has not already been processed or approved.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/order_id/fee_requests/{fee_request_id}
Method: DELETE
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57074785/fee_requests/7507510 |
Request Body: NA
Response:
{ "message": "Fee request deleted successfully." } |