Overview

The AccountingDocuments Status API allows for the retrieval of the current processing status of an invoice submitted to Basware.

This API is intended for visibility into invoice processing without retrieving the complete invoice document. The API returns the current invoice status and related invoice information based on the invoice search criteria provided in the request.

Note: This API is not active by default. To activate the API, please reach out to Basware Support.

Request Method: GET

Endpoint: /v1/accountingDocuments/status 

Request Parameters

The API searches for invoices using the information provided in the request.

All required fields must match an existing invoice for a status to be returned.

Example Request:

Example Response:

[
  {
    "invoiceId": "fbc082a265a4469cb230d84a252f18fc",
    "status": "InApprovalProcess",
    "processingStatus": "New",
    "disputeInfo": {
      "isDisputed": true,
      "disputeReason": "DamagedGoods",
      "disputeDate": "2026-07-17T18:13:47.340Z"
    },
    "lastUpdated": "2026-07-17T18:13:47.340Z"
  }

You can also find more details in the API documentation here: Basware P2P APIs SwaggerUI 

Invoice Status Values:

The API can return the following statuses:

Best Practices:

• Use the exact invoice number and invoice date values used during invoice submission.
• Include the gross invoice amount whenever possible to improve match accuracy.
• Store the returned status information in your application for reporting and tracking purposes.
• Use the Status API when only invoice status information is required. If complete invoice details are needed, use the AccountingDocuments API instead. 

Basic Troubleshooting if No Invoice Found

Verify that:

• CompanyCode is correct.
• InvoiceNumber matches the submitted invoice.
• InvoiceDate is provided in the correct format.
• GrossSum matches the invoice amount if included in the request.
• The invoice was created, cancelled, resent, or sent to transfer (if using Basware API for invoice transfer) after the status API was enabled in Basware.

In order to enable the Status API and in case of any further concerns, please reach out to Basware Support.