---
title: "Search for an organization in the BILL Network"
method: GET
path: "/v3/network"
tags: ["network"]
---

# Search for an organization in the BILL Network

`GET /v3/network`

Search for a customer, vendor, or verified national vendor organization. You can search in the BILL Network and verified national vendor (`RPPS`) network.

When you search in the BILL Network, there are two `name` requirements for getting search results.
* Your search term must have a minimum of three characters.
* Your search term must be a complete word. You will not get search results when your search term is a partial word.

When you search in the verified national vendor (`RPPS`) network, search results are based on both a complete and partial match on `name` and `zipOrPostalCode`. You can further filter your search by the billing statement `accountNumber` with the vendor. For example, your Verizon internet bill account number.

See [BILL Network](https://developer.bill.com/docs/bill-network) in the Guides section for more information, sample requests, and responses.

## Query parameters

- `name` string, required — Organization name
- `scope` 'BILL' | 'RPPS' | 'ALL', nullable — Network name. You can search in one or both networks. * Select `BILL` for BILL Network * Select `RPPS` for verified national vendor network * Select `ALL` for both networks
- `zipOrPostalCode` string, nullable — Organization zip or postal code. When you set this field, BILL searches with `zipOrPostalCode` for all organizations.
- `accountNumber` string, nullable — Your billing statement account number with the verified national vendor (`RPPS`) organization

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Search for an organization in the BILL Network response

- NetworkSearchResponseDto — Network search response.
  - `results` Network[] — Results that match the search criteria
    - `id` string — Payment Network ID (PNI) of the organization. BILL uses the PNI to send and receive electronic payments.
    - `name` string — Organization name
    - `type` 'ADVANCED' | 'BUSINESS' | 'RPPS' | 'CONTRACTOR' | 'EMPLOYEE_OR_INDIVIDUAL' | 'UNDEFINED' — Account type.
    - `addresses` AddressDto[] — Organization address
      - `line1` string — Address line 1
      - `line2` string — Address line 2
      - `city` string — City
      - `stateOrProvince` string — State or province
      - `zipOrPostalCode` string — Zip or postal code
      - `country` string — Country
    - `managedBy` object — Search result metadata information
      - `name` string — Network managed by name
      - `email` string — Network managed by email address
      - `emailDomain` string — Verified email address domain

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)