# May 13, 2026 

** May 13, 2026 Karbon API release adds InvoiceStatus filtering on the Invoices endpoint and makes the BusinessCards array optional when updating Contacts and Organizations. **
---

## Filter Invoices by InvoiceStatus

Making a `GET` request to `/v3/Invoices` now supports filtering by `InvoiceStatus`, making it easier to retrieve only the invoices in a particular state.

For example:

```
GET /v3/Invoices?$filter=InvoiceStatus eq 'Approved'
```

This returns only invoices whose status matches the provided value.

The following `InvoiceStatus` values are supported:

| Value | Description |
|---|---|
| `Approved` | Invoice has been approved and is ready to be sent or paid |
| `AwaitingPayment` | Invoice has been issued and is awaiting payment |
| `Paid` | Invoice has been paid in full |
| `Exported` | Invoice has been exported to an external system |
| `Voided` | Invoice has been voided |

## BusinessCards is Now Optional When Updating Contacts and Organizations

`PUT` requests to `/v3/Contacts/{ContactKey}` and `/v3/Organizations/{OrganizationKey}` no longer require the `BusinessCards` array in the payload. This makes it simpler to update other properties on a Contact or Organization without first fetching and resubmitting the full set of Business Cards.

When the `BusinessCards` property is omitted from the request body, the existing Business Cards on the Contact or Organization are left untouched. To update Business Card fields, continue to include the `BusinessCards` array as before.