---
title: "Search Biller Directory"
method: POST
path: "/searchBillerDirectory"
tags: ["Transactions"]
---

# Search Biller Directory

`POST /searchBillerDirectory`

Use the Search Biller Directory endpoint to find billers in the <<glossary:RPPS>> database. Pass `billerName` (required), `billerState` (recommended) and `billerAccountNo` (optional). If the biller is in the RPPS database, the endpoint returns the RPPS biller ID (`rpps_biller_id`), which you pass in the <a href="ref:post_addrppsbiller" target="_blank">Add RPPS Biller</a> endpoint call. If the biller is not present, use <a href="ref:post_addpaperbiller" target="_blank">Add Paper Biller</a> to add the biller.

If the biller is present in the RPPS directory, the endpoint might return `biller_account_no_patterns`, which you can use as a mask to validate the account number.

See <a href="doc:creating-a-billpay-transaction" target="_blank">Creating a Billpay Transaction</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.
    - `billers` object[] — List of transfer accounts
      - `rpps_biller_id` string, required — Remote Payment and Presentment Service provider ID
      - `biller_name` string, required — Name of the biller
      - `biller_address1` string, nullable, required — Street and residence number on the account
      - `biller_address2` string, nullable, required — Additional address information on the account
      - `biller_city` string, nullable, required — City for address information
      - `biller_state` string, nullable, required — State for address information
      - `biller_zip` string, nullable, required — Zip code for address information
      - `biller_account_no_patterns` string[], nullable, required — The account number patterns that are used by the biller. See the Account Patterns Legend below

---

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