Applies to integrated customers using the RecoveryConnect API



Get Company Receivable Standard Invoices

Description: This endpoint retrieves the list of receivable standard invoices associated with the authenticated user's company.

Receivable standard invoices represent amounts that the company expects to receive from clients or customers under the standard (contract-driven) invoicing model. This endpoint supports filtering based on invoice status and payment status, enabling efficient tracking of revenue and collections.

All requests must include a valid Bearer Token in the request header.

 

URL: /api/v150/company/receivable_standard_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_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 Company Payable Standard Invoices

Description: This endpoint retrieves the list of payable standard invoices associated with the authenticated user's company.

Payable standard invoices represent amounts that the company needs to pay to vendors or service providers under the standard (contract-driven) invoicing model. This endpoint supports filtering based on invoice status, submitting company, and parent order, enabling efficient tracking of outgoing payments and approval workflows.

All requests must include a valid Bearer Token in the request header.

 

URL: /api/v150/company/payable_standard_invoices

Method: GET

Query Parameters:

PARAMETER

DESCRIPTION

MANDATORY

EXAMPLE

invoice_status

Filters invoices based on 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_standard_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

        }

      ]

    }

  ]

}

 

Update Company Payable Standard Invoice

Description: This endpoint updates a specific payable standard 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_standard_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": 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": "approved",

        "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-03-21 16:02:14",

        "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

            }

        ]

    }

}