---
title: "Retrieves a paginated list of supplier bill payments, including payment allocations to specific bills."
method: GET
path: "/api/BillPayment"
tags: ["BillPayment"]
---

# Retrieves a paginated list of supplier bill payments, including payment allocations to specific bills.

`GET /api/BillPayment`

## Query parameters

- `UpdatedAfter` string, date-time
- `pageSize` integer
- `pageNumber` integer

## Response `200`

Returns a paginated list of bill payments with allocations.

- BillPaymentList — Paginated collection of supplier bill payments.
  - `TotalCount` integer — Total number of payments matching the filter criteria.
  - `PageNumber` integer — Current page number (1-based).
  - `PageSize` integer — Number of results per page.
  - `Payments` BillPayment[] — The list of bill payments for this page.
    - `TransactionID` integer — Unique identifier for the payment transaction.
    - `AccountIDFK` integer — The Avaza account this payment belongs to.
    - `TransactionPrefix` string — The prefix used in the payment number.
    - `PaymentNumber` string — The full payment number including prefix.
    - `TransactionReference` string — External reference number (e.g. cheque number or bank reference).
    - `SupplierIDFK` integer — The supplier company ID this payment is made to.
    - `DateIssued` string, date-time — The date the payment was made.
    - `TransactionStatusCode` string — Current status of the payment.
    - `PaymentProviderCode` string — Code identifying the payment provider/method used.
    - `ExchangeRate` number, double — Exchange rate to the account's base currency.
    - `Balance` number, double — Unallocated balance remaining on the payment.
    - `CurrencyCode` string — ISO 3-character currency code for the payment.
    - `TotalAmount` number, double — Total payment amount.
    - `Notes` string — Additional notes on the payment.
    - `DateCreated` string, date-time — Date and time the record was created.
    - `DateUpdated` string, date-time — Date and time the record was last updated.
    - `PaymentAllocations` BillPaymentAllocation[] — List of allocations applying this payment to specific bills.
      - `TransactionAllocationID` integer — Unique identifier for this payment allocation.
      - `BillTransactionIDFK` integer — The bill Transaction ID this payment is allocated against.
      - `PaymentTransactionIDFK` integer — The payment Transaction ID this allocation belongs to.
      - `AllocationDate` string, date-time — The date this allocation was applied.
      - `AllocationAmount` number, double — The amount allocated from the payment to the bill.
    - `ViewBillPaymentURL` string — URL to view this bill payment in the Avaza web application.

## 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)