Applies to integrated customers using the RecoveryConnect API
Standard Invoice Operations
The Standard Invoice Operations section provides endpoints used to create, retrieve, update, and manage standard invoices associated with orders. These endpoints also support managing service items, expenses, and fee requests linked to invoices.
All requests must include a valid Bearer token in the request header.
Get Invoice Details – SI and Standard Invoice
Description: This endpoint retrieves the details of a specific invoice.
The API supports retrieving both Standard Invoices and Smart Invoices. Based on the provided invoice_id, the system will return the corresponding invoice details, including billing information, associated order or assignment references, invoice status, and financial details.
Invoices represent billing records generated for services performed on orders or assignments.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/invoices/{invoice_id}
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/invoices/10071126 |
Request Body: NA
Response:
{ "data": { "data": { "id": 10071126, "company_id": 131051, "billed_company_id": 127562, "employee_id": 384530, "company_refno": 26608, "reference_number": null, "orders_id": 86494770, "type": "Invoice", "client_last_history": "approved", "gross_amount": 158.98, "tax_amount": 0, "is_sent": 1, "status": "unpaid", "due_date": "2025-09-24 12:00:00", "date_accepted": null, "is_recurring": 0, "created_at": "2025-08-25 18:07:34", "updated_at": "2025-08-25 21:48:08", "date_sent": "2025-08-25 18:09:08", "date_paid": null, "order_fulfillment_history_id": null, "from_location": 2156986, "to_location": 1595372, "approval_type": 2, "autorized_by": 273968, "autorization_date": "2025-08-25 00:00:00", "lender_accept_date": "2025-08-25", "migration": null, "is_editable": 0, "is_late": 0, "is_contracted": 1, "is_auto_approved": null, "is_staff_approved_required": 0, "is_supervisor_approved_required": 0, "is_manager_approved_required": null, "re_submitted": 0, "external_reference_num": null, "payments": [ { "id": 3726136, "created_by": 262258, "transaction_number": null, "transaction_id": 10071126, "payment_type": "Check", "payment_from": 127562, "transaction_item_id": null, "remarks": "test", "amount": 122, "refNo": "test123456", "status": "paid", "created_at": "2025-08-25 21:48:32", "updated_at": "2025-08-25 21:48:32", "paid_at": "2025-08-25 07:00:00", "expense": 0, "deleted_at": null } ], "transaction_items": [ { "id": 12829290, "transaction_id": 10071126, "transaction_service_provider_id": null, "item_id": 1020524, "department_billing_item_id": null, "gross_amount": 158.98, "discount_amount": 0, "tax_amount": 0, "net_amount": 158.98, "quantity": 1, "remarks": null, "is_expense": 0, "pay_to_id": null, "pay_to_type": null, "created_at": "Aug 25, 2025", "cla_active": 0, "use_override": null, "updated_at": "2025-08-25 18:09:08", "approval_status": "Approved", "offer_amount": null, "old_tax_amount": null, "migration": null, "approval_type": 3, "employee_id": 10001, "approved_by": 0, "approved_date": null, "is_supervisor_approved_required": null, "is_manager_approved_required": null, "is_contracted": 1, "bill_to_borrower": "No", "is_auto_approved": null, "is_staff_approved_required": 1, "item_detail": null } ] } } } |
Create Standard Invoice
Description: This endpoint creates a Standard Invoice for a specific order.
Standard invoices are typically predefined and contract-driven invoices, where billing is generated based on fixed configurations, predefined fee structures, or system-generated logic, unlike Smart Invoices which are more dynamic.
This endpoint is used when the invoice follows a standard billing process without manual customization of service items and expenses.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
billTo | Identifier of the entity to whom the invoice is billed | Yes | 65690 |
invoiceDueDate | Due date and time for the invoice | Yes | 2025-08-28 11:02.57 |
bill_from_location | Location ID from where the invoice is generated | Yes | 16217129 |
bill_to_location | Location ID where the invoice is billed | Yes | 56458222 |
invoiceCollaterals | Array of collateral IDs included in the invoice | Yes | [58140207] |
itemsToAdd | |||
itemID | Identifier of the service item | Yes | 1016235 |
itemDate | Date and time of the service | Yes | 2025-08-28 11:02.57 |
itemQty | Quantity of the item | Yes | 1 |
itemCost | Cost of the item | Yes | 122 |
itemRemarks | Remarks or description for the item | No | Adding Personal Property Storage Fee |
itemTaxRate | Array of applicable tax rate IDs | No | [253] |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57074726/standard_invoices |
Request Body:
{ "billTo": 65690, "invoiceDueDate": "2026-08-28 11:02.57", "bill_from_location": 16217129, "bill_to_location": 56458222, "invoiceCollaterals": [ 58140207 ], "itemsToAdd": [ { "itemID": 1016235, "itemDate": "2026-08-28 11:02.57", "itemQty": 1, "itemCost": 122, "itemRemarks": "Adding Personal Property Storage Fee", "itemTaxRate": [ 253 ] } ] } |
Response:
{ "data": { "id": 6006470, "order_id": 56226663, "order_type_id": 1, "billed_company_id": 65690, "billed_company_name": "Demo Bank and Trust MRS", "company_refno": 19015, "status": "draft", "gross_amount": 500, "tax_amount": 68.75, "is_sent": 0, "is_recurring": 0, "payment_status": "unpaid", "due_date": "2023-04-09 12:00:00", "date_accepted": "2023-04-09 12:00:00", "created_at": "2024-04-04 00:00:00", "updated_at": "2023-03-09 23:23:00", "date_sent": "2023-03-09 23:23:00", "date_paid": "2024-04-04 23:23:00", "from_location": 4, "to_location": 276417, "is_contracted": 1, "service_items": [ { "id": 928101, "item_id": 6006470, "item_name": "Collateral Redemption Reinstatement Fee", "gross_amount": 75.3, "tax_amount": 10.35, "net_amount": 85.65, "quantity": 1, "remarks": "testing", "is_expense": 0, "pay_to_id": 23992, "pay_to_type": "employee", "created_at": "2024-04-04 00:00:00", "updated_at": "2024-04-04 00:00:00", "approval_status": "Approved", "is_contracted": 1 } ] } } |
Get Order Standard Invoices
Description: This endpoint retrieves the list of standard invoices associated with a specific order.
Standard invoices are contract-driven billing records generated for an order. This endpoint allows users to view all standard invoices created for the given order, along with their status and summary financial details.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/6006470/standard_invoices |
Request Body: NA
Response:
{ "data": [ { "id": 6006470, "order_id": 56226663, "order_type_id": 1, "billed_company_id": 65690, "billed_company_name": "Demo Bank and Trust MRS", "company_refno": 19015, "status": "draft", "gross_amount": 500, "tax_amount": 68.75, "is_sent": 0, "is_recurring": 0, "payment_status": "unpaid", "due_date": "2023-04-09 12:00:00", "date_accepted": "2023-04-09 12:00:00", "created_at": "2024-04-04 00:00:00", "updated_at": "2023-03-09 23:23:00", "date_sent": "2023-03-09 23:23:00", "date_paid": "2024-04-04 23:23:00", "from_location": 4, "to_location": 276417, "is_contracted": 1, "service_items": [ { "id": 928101, "item_id": 6006470, "item_name": "Collateral Redemption Reinstatement Fee", "gross_amount": 75.3, "tax_amount": 10.35, "net_amount": 85.65, "quantity": 1, "remarks": "testing", "is_expense": 0, "pay_to_id": 23992, "pay_to_type": "employee", "created_at": "2024-04-04 00:00:00", "updated_at": "2024-04-04 00:00:00", "approval_status": "Approved", "is_contracted": 1 } ] } ] } |
Get Order Standard Invoice
Description: This endpoint retrieves the details of a specific standard invoice associated with an order.
Standard invoices are contract-driven billing records that include predefined service items and billing configurations. This endpoint provides a detailed view of a single standard invoice, including billing details, items, and invoice status.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470 |
Request Body: NA
Response:
{ "data": { "id": 6006470, "order_id": 56226663, "order_type_id": 1, "billed_company_id": 65690, "billed_company_name": "Demo Bank and Trust MRS", "company_refno": 19015, "status": "draft", "gross_amount": 500, "tax_amount": 68.75, "is_sent": 0, "is_recurring": 0, "payment_status": "unpaid", "due_date": "2023-04-09 12:00:00", "date_accepted": "2023-04-09 12:00:00", "created_at": "2024-04-04 00:00:00", "updated_at": "2023-03-09 23:23:00", "date_sent": "2023-03-09 23:23:00", "date_paid": "2024-04-04 23:23:00", "from_location": 4, "to_location": 276417, "is_contracted": 1, "service_items": [ { "id": 928101, "item_id": 6006470, "item_name": "Collateral Redemption Reinstatement Fee", "gross_amount": 75.3, "tax_amount": 10.35, "net_amount": 85.65, "quantity": 1, "remarks": "testing", "is_expense": 0, "pay_to_id": 23992, "pay_to_type": "employee", "created_at": "2024-04-04 00:00:00", "updated_at": "2024-04-04 00:00:00", "approval_status": "Approved", "is_contracted": 1 } ] } } |