Basware API - AccountingDocuments Status API

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.

Parameter	Required	Description
CompanyCode	Yes	Company code associated with the invoice
InvoiceNumber	Yes	Invoice number
InvoiceDate	Yes	Invoice date
GrossSum	No	Gross invoice amount for additional validation

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

Example Request:

Method: GET

https://api.us.basware.com/v1/accountingDocuments/status?CompanyCode=1000&InvoiceNumber=INV-12345&InvoiceDate=2025-01-15&GrossSum=1250.00

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:

Status	Description
InApprovalProcess	The invoice has been received and is currently being processed.
ReadyForPayment	The invoice has been approved and transferred for payment processing.
Paid	The invoice has been paid.
Rejected	The invoice has been rejected.
Disputed	The invoice is currently under dispute.

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.