Applies to integrated customers using the RecoveryConnect API
Get Company Payable Smart Invoice
Description: This endpoint retrieves the details of a specific payable smart invoice for the authenticated user's company.
Payable invoices represent amounts that the company is required to pay to vendors or service providers. This endpoint provides a detailed view of a single invoice, including billing details, status, amounts, and associated service items.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/company/payable_invoices/{invoice_id}
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/company/payable_invoices/6065386 |
Request Body: NA
Response:
{ "data": { "id": 6065386, "service_provider_order_id": 57045738, "service_provider_order_type_id": 1, "parent_order_id": 57045736, "parent_order_type_id": 1, "submitted_by": 10001, "submitted_by_name": "Recovery Office Pro Demo &", "submitted_by_refno": 33210, "status": "submitted", "gross_amount": "505.00", "tax_amount": "0.00", "is_sent": 1, "payment_status": "unpaid", "due_date": "2026-02-20 12:00:00", "date_accepted": null, "is_recurring": 0, "created_at": "2026-01-21 13:46:09", "updated_at": "2026-01-21 13:46:19", "date_sent": "2026-01-21 13:46:19", "date_paid": null, "from_location": 119858187, "to_location": 4, "is_contracted": 1, "approval_level": "Staff", "service_items": [ { "id": 7507814, "item_id": 1019153, "item_name": "Personal Property Storage Fee", "master_id": 1510, "gross_amount": "505.00", "tax_amount": "0.00", "net_amount": "505.00", "quantity": 1, "remarks": "", "is_expense": 0, "pay_to_id": null, "pay_to_type": null, "created_at": "2026-01-21 00:00:00", "updated_at": "2026-01-21 13:46:19", "approval_status": "Approved", "is_contracted": 1 } ] } } |
Update Company Payable Smart Invoice
Description: This endpoint updates a specific payable smart invoice for the authenticated user's company.
It is primarily used in the invoice approval workflow, allowing users to update the invoice status and add notes during review or approval.
Only the fields provided in the request body will be updated. Fields not included will remain unchanged.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/company/payable_invoices/{invoice_id}
Method: PUT
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
status | Updated status of the invoice (e.g., Approved, Rejected, Pending) | Yes | Approved |
notes | Remarks or comments related to the update or approval | No | Approving the invoice as all required docs are submitted |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/company/payable_invoices/6065386 |
Request Body:
{ "status": "Approved", "notes": "Approving the invoice as all required docs are submitted" } |
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 } ] } } |
Get Company Receivable Smart Invoices
Description: This endpoint retrieves the list of receivable smart invoices associated with the authenticated user's company.
Receivable invoices represent amounts that the company expects to receive from clients or customers. This endpoint supports filtering based on invoice status and payment status, helping track revenue and payment collections.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/company/receivable_invoices
Method: GET
Query Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
invoice_status | Filters invoices based on status (e.g., draft, submitted, approved) | No | ?invoice_status=approved |
payment_status | Filters invoices based on payment status (e.g., unpaid, partially_paid, paid) | No | ?payment_status=unpaid |
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/receivable_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 } ] } ] } |