---
title: "Retrieves a paginated list of supplier bills with line items, status, and address details. Supports filtering by company, status, date ranges, and updated date."
method: GET
path: "/api/Bill"
tags: ["Bill"]
---

# Retrieves a paginated list of supplier bills with line items, status, and address details. Supports filtering by company, status, date ranges, and updated date.

`GET /api/Bill`

TransactionStatusCode values are: "Draft", "Verified", "Late", "Paid", "Partial", "Void"

## Query parameters

- `UpdatedAfter` string, date-time
- `pageSize` integer
- `pageNumber` integer
- `TransactionStatusCode` string
- `IssueDateFrom` string, date-time
- `IssueDateTo` string, date-time
- `DueDateFrom` string, date-time
- `DueDateTo` string, date-time
- `Sort` string
- `CompanyIDFK` integer

## Response `200`

Returns a paginated list of bills with line items and address details.

- BillList — Paginated collection of supplier bills.
  - `TotalCount` integer — Total number of bills matching the filter criteria.
  - `PageNumber` integer — Current page number (1-based).
  - `PageSize` integer — Number of results per page.
  - `Bills` Bill[] — The list of bills for this page.
    - `TransactionID` integer — Unique identifier for the bill transaction.
    - `AccountIDFK` integer — The Avaza account this bill belongs to.
    - `TransactionPrefix` string — The prefix used in the bill number (e.g. 'BILL').
    - `BillNumber` string — The full bill/invoice number including prefix.
    - `CompanyIDFK` integer — The supplier company ID this bill is from.
    - `CompanyName` string — The name of the supplier company.
    - `Subject` string — Subject line or description for the bill.
    - `DateIssued` string, date-time — The date the bill was issued.
    - `DateVerified` string, date-time — The date the bill was verified/approved.
    - `DueDate` string, date-time — The payment due date for the bill.
    - `TransactionStatusCode` string — Current status of the bill. Values: Draft, Verified, Late, Paid, Partial, Void.
    - `TaxAmount` number, double — Total tax amount across all line items.
    - `TransactionTaxConfigCode` string — Tax configuration: 'EX' (tax exclusive) or 'INC' (tax inclusive).
    - `Balance` number, double — Outstanding balance remaining on the bill.
    - `CurrencyCode` string — ISO 3-character currency code for the bill.
    - `TotalAmount` number, double — Total amount of the bill including tax.
    - `ExchangeRate` number, double — Exchange rate to the account's base currency. 1.0 if same currency.
    - `Notes` string — Additional notes or comments on the bill.
    - `SupplierPONumber` string — Supplier purchase order number reference.
    - `DateCreated` string, date-time — Date and time the record was created.
    - `DateUpdated` string, date-time — Date and time the record was last updated.
    - `LineItems` BillLineItem[] — Line items on this bill.
      - `TransactionLineItemID` integer — Unique identifier for the line item.
      - `InventoryItemIDFK` integer — The inventory/product item ID for this line item.
      - `InventoryItemName` string — Name of the inventory/product item.
      - `InventoryItemSKU` string — Stock Keeping Unit code for the inventory item.
      - `Description` string — Text description for the line item.
      - `Quantity` number, double — Quantity of items on this line.
      - `UnitPrice` number, double — Price per unit for this line item.
      - `TaxAmount` number, double — Total tax amount for this line item.
      - `TaxIDFK` integer — The tax rate ID applied to this line item.
      - `TaxCode` string — Short code for the applied tax rate.
      - `TaxName` string — Name of the applied tax rate.
      - `ProjectIDFK` integer — Optional project ID this line item is attributed to for reporting.
      - `ProjectTitle` string — Title of the associated project.
      - `Amount` number, double — Calculated line total (Quantity x UnitPrice less Discount).
      - `Discount` number, double — Discount percentage applied to this line item.
    - `Links` BillLinks — URLs for viewing and editing a bill in the Avaza web application.
      - `WebView` string — URL for viewing the bill in a web browser.
      - `View` string — URL for viewing the bill in the Avaza application.
      - `Edit` string — URL for editing the bill in the Avaza application.
    - `Issuer` BillIssuerDetails — Billing address details for the supplier who issued the bill.
      - `CompanyIDFK` integer — The supplier company ID this bill is from.
      - `CompanyName` string — The name of the supplier company.
      - `BillingAddress` string — Formatted multi-line billing address.
      - `BillingAddressLine` string — Street address line of the billing address.
      - `BillingAddressCity` string — City/suburb of the billing address.
      - `BillingAddressState` string — State/province of the billing address.
      - `BillingAddressPostCode` string — Postal/ZIP code of the billing address.
      - `BillingCountryCode` string — ISO 3166-1 alpha-2 country code of the billing address.
    - `Recipient` BillRecipientDetails — Billing address details for the Avaza account (the recipient of the bill).
      - `RecipientFormattedBillingAddress` string — Pre-formatted multi-line billing address for the recipient.
      - `RecipientBillingAddressLine` string — Street address line for the recipient.
      - `RecipientBillingAddressCity` string — City/suburb for the recipient.
      - `RecipientBillingAddressState` string — State/province for the recipient.
      - `RecipientBillingAddressPostCode` string — Postal/ZIP code for the recipient.
      - `RecipientBillingAddressCountryCode` string — ISO country code for the recipient.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)