Applies to integrated customers using the RecoveryConnect API
Create Repo Invoice
Description: This endpoint creates a Repo Invoice for a specific order.
A Repo Invoice is a system-generated invoice based on contract and recovery-related activities, including service items and applicable taxes. It is typically used when billing is derived from predefined contract rules and completed recovery operations.
The created invoice includes billing details, service items, tax calculations, and invoice status, and can be further processed within the invoicing workflow.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/order_id/repo_invoice
Method: POST
Request Body Parameters: No request body is required for this endpoint.
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/57036454/contract_details |
Request Body: No request body is required for this endpoint.
Response:
{ "data": { "id": 6067084, "order_id": 57074785, "order_type_id": 1, "billed_company_id": 65690, "billed_company_name": "Demo Bank & Trust MRS", "company_refno": 34833, "status": "draft", "gross_amount": "395.00", "tax_amount": "0.00", "is_sent": 0, "payment_status": "unpaid", "due_date": "2026-04-19 12:00:00", "date_accepted": null, "is_recurring": 0, "created_at": "2026-03-20 11:17:11", "updated_at": "2026-03-20 11:17:11", "date_sent": null, "date_paid": null, "from_location": 4, "to_location": 56458222, "is_contracted": 1, "service_items": [ { "id": 7510026, "item_id": 1018861, "item_name": "Involuntary Repossession", "master_id": 1500, "gross_amount": "395.00", "tax_amount": "0.00", "net_amount": "395.00", "quantity": 1, "remarks": null, "is_expense": 0, "pay_to_id": null, "pay_to_type": null, "created_at": "2026-03-20 12:00:00", "updated_at": "2026-03-20 12:00:00", "approval_status": "Approved", "is_contracted": 1 } ] } } |
Attach Fee Request to Smart Invoice
Description: This endpoint attaches one or more existing fee requests to a smart invoice.
Fee requests represent pre-approved or pending billing charges created earlier in the workflow. By attaching them to a smart invoice, these charges become part of the invoice total and billing breakdown.
This endpoint is typically used to integrate fee requests into the smart invoice before final submission or approval.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/order_id/invoices/{invoice_id}/fee_requests/attach
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
fee_request_ids | Array of fee request IDs to be attached to the invoice | Yes | [7428684] |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/invoices/6067084/fee_requests/attach |
Request Body:
{ "fee_request_ids": [ 7428684 ] } |
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 Company Payable Smart Invoices
Description: This endpoint retrieves the list of payable smart invoices associated with the authenticated user's company.
Payable invoices represent invoices that the company needs to pay to vendors or service providers. This endpoint supports multiple filters to refine results based on approval level, invoice status, submitting company, and order hierarchy.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/company/payable_invoices
Method: GET
Query Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
approval_level | Filters invoices based on approval level. Possible values: Staff, Manager, Supervisor | No | ?approval_level=Manager |
invoice_status | Filters invoices based on their status (e.g., draft, submitted, approved) | No | ?invoice_status=submitted |
submitted_by | Filters invoices by the company ID that submitted the invoice | No | ?submitted_by=65690 |
parent_order_id | Filters invoices based on the parent order ID | No
| ?parent_order_id=57070537 |
per_page | Number of records returned per page. Default is 250 | No
| ?per_page=100 |
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/company/payable_invoices |
Request Body: NA
Response:
{ "data": [ { "id": 6006470, "service_provider_order_id": 56226663, "service_provider_order_type_id": 1, "parent_order_id": 56226663, "parent_order_type_id": 1, "submitted_by": 10001, "submitted_by_name": "Recovery Office Pro Demo", "submitted_by_refno": 9398, "status": "submitted", "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, "approval_level": "staff", "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 } ] } ] } |