BIbill
vendors

Get list of vendors

Changed on

Get a list of vendor objects. By default, you get 20 results on one page of results. Set max in your request to get up to 100 results on one page.

See Search operations with lists in the Guides section for filtering, sorting, and pagination examples.

get/v3/vendors

Request

  • Base URL
    https://gateway.stage.bill.com/connect
  • URL
    https://gateway.stage.bill.com/connect/v3/vendors
  • Auth
    none declared

Query parameters

maxinteger nullable

Maximum number of results

Example:10
sortstring nullable

Field name and sort order. Both simple and compound sorting is available.

The format is sort={field_01}:{sort_order},{field_02}:{sort_order}.

NOTE: Sorting occurs in the specified order.

Example:createdTime:desc
filtersstring nullable

Field name, operator, and value. Both simple and compound filtering is available.

The format is filters={field_01}:{op}:{value},{field_02}:{op}:{value}.

The fz operator performs a fuzzy match and is supported only on name, for example filters=name:fz:acme corp. It returns vendors whose names approximately match the search term, ordered by the other sort criteria.

Example:id:eq:{{vendor_id}}
pagestring nullable

Next page of results.

When a list has multiple pages, the nextPage and prevPage values in the response enable you to navigate between the pages of results. Set page as the nextPage or prevPage value for navigation.

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}
devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Response

Get list of vendors response

nextPagestring
prevPagestring
countinteger

Total number of vendors matching the list request filters, across all pages of results.

Example response

{
  "results": [
    {
      "paymentInformation": {
        "bankAccount": {
          "nameOnAccount": "Bill Vendorson",
          "accountNumber": "111222333",
          "routingNumber": "074000010",
          "type": "CHECKING",
          "ownerType": "BUSINESS",
          "paymentCurrency": "USD"
        }
      }
    }
  ]
}

Changes

  • 54edddceb0a5Revision changes
    • breaking

      the ///////////////// response's property type changed from string to no type for status

    • breaking

      the ///////////////// response's property type changed from string to no type for status

    • info

      added subschema #2 to the response body allOf list for the response status

    • info

      added the optional property ////// to the response with the status

    • info

      added subschema #2 to the ///////////////// response property allOf list for the response status

    • info

      added subschema #2 to the ///////////////// response property allOf list for the response status