---
title: "Get Bill Payment History"
method: POST
path: "/getBillPayHistory"
tags: ["Transactions"]
---

# Get Bill Payment History

`POST /getBillPayHistory`

Use the Get Bill Payment History endpoint to retrieve bill payment transactions between the specified dates, including scheduled transactions. You can get the history for the specified account or for all related accounts.

See <a href="doc:managing-billpay-transactions" target="_blank">Managing Billpay Transactions</a> for instructions on using this endpoint.

## Response `default`

- object
  - `status_code` integer, nullable, required — The response status code. May return a string for some statuses.
  - `status` string, nullable, required — The condition of a process or response
  - `processing_time` number, float, nullable, required — The time elapsed in processing the transaction
  - `echo` object, nullable, required — A structure that contains transaction ID information
    - `transaction_id` string, nullable, required — An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required — Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required — Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required — A system generated timestamp
  - `rtoken` string, nullable, required — A system-generated ID used for tracking
  - `errors` string[] — A list of errors generated while the request was processed
  - `response_data` object, nullable, required — A structure for the response data. It can be empty but usually will contain information.
    - `found` integer, required — The total number of bill payments found
    - `bill_payments` object[], required — List of bill payment objects
      - `pmt_ref_no` string, required — A system-generated account number
      - `billpay_transaction_id` string, required — An ID assigned to a bill payment transaction
      - `amount` string, required — The amount of the bill payment
      - `process_date` string, date-time, nullable, required — The date the payment was processed
      - `biller_id` string, required — Positive integer value of a customer configured biller
      - `name` string, nullable, required — The name of the biller
      - `nickname` string, nullable, required — A nickname used to identify a biller entity
      - `status` string, required — The status of the payment. See <a href="ref:api-reference-bill-payment-statuses" target="_blank">Bill Payment Statuses</a>.
      - `type` string, required — `P` for paper or `E` for electronic
      - `external_trans_id` string, nullable, required — The `transactionId` from the Create Bill Payment call that created the transaction.
      - `printed_date` string, date-time, nullable, required — The date the paper check was mailed or the electronic bill payment was sent to Mastercard.
      - `cleared_date` string, date-time, nullable, required — The date the paper check cleared the bank.

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/versions/bcd728f97a18/schema)