---
title: "Get Billers"
method: POST
path: "/getBillers"
tags: ["Transactions"]
---

# Get Billers

`POST /getBillers`

Use the Get Billers endpoint to retrieve the billers for the specified customer account.

See <a href="doc:creating-a-billpay-transaction" target="_blank">Creating a Billpay Transaction</a> for instructions on using this endpoint.

See <a href="ref:record-set-paging" target="_blank">Record-Set Pagination</a> for instructions on using the paging parameters.

## 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.
    - `billers` object[], required — List of billers
      - `account_number` string, required — The account number of the biller entity
      - `address_1` string, nullable — Street and residence number on the account
      - `address_2` string, nullable — Additional address information on the account
      - `biller_id` string, required — An ID assigned to the biller
      - `city` string, nullable — City for address information
      - `name` string, nullable, required — A name used to identify a biller entity
      - `nickname` string, nullable — A substring of the biller `name`.
      - `phone` string, nullable — The main phone number on the biller account
      - `postal_code` string, nullable — A postal code for the address information
      - `state_province` string, nullable — State for address information
      - `type` string, required — The type of biller: `P` (paper) or `E` (electronic, RPPS)
      - `frequency_type` string, nullable — Frequency of the bill payment
      - `next_date` string, date, nullable — The next date that the payment is scheduled
      - `end_date` string, date, nullable — The last date that the payment is scheduled. Can be up to five years in the future
      - `amount` number, float, nullable — Currency amount as a whole or decimal amount
    - `found` integer, required — The total number of billers found
    - `page` integer, required — The page number to be retrieved in the context of recordset paging
    - `total_record_count` integer, required — Number of records in the accounts list display
    - `number_of_pages` integer, required — Total number of pages in the accounts list display

---

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