---
title: "Get list of vendor payment options"
method: GET
path: "/v3/payments/options"
tags: ["payments"]
---

# Get list of vendor payment options

`GET /v3/payments/options`

Get a list of vendor payment options available based on the funding account options available in the signed-in user's BILL organization and on the payment methods accepted by a vendor.

See [Vendor payment options](https://developer.bill.com/docs/vendor-payment-options) in the Guides section for more information, sample requests, and responses.

## Query parameters

- `vendorId` string, required — BILL-generated ID of the vendor to be paid. The value begins with `009`.
- `amount` number, required — Vendor payment amount

## Headers

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

## Response `200`

Get list of vendor payment options response

- PaymentOptionsResponseDto — Payments options response dto.
  - `vendorId` string, required — BILL-generated ID of the vendor to be paid. The value begins with `009`.
  - `amount` number, required — Vendor payment amount
  - `fundingOptions` object — Funding options
    - `banks` BankFundingOption[] — Bank account options
      - `available` boolean — This field is set as `true` if the funding account is available for vendor payments
      - `deliveryDate` string, date — Vendor payment delivery date. The value is in the `yyyy-MM-dd` format.
      - `processDate` string, date — Vendor payment process date. The value is in the `yyyy-MM-dd` format. On this date, BILL starts processing the payment and starts withdrawing funds from the sender's funding account.
      - `reason` string — Reason why the funding account is not available for vendor payments
      - `conditions` string[] — Additional information required for vendor payments with the funding account
      - `id` string — BILL-generated ID of the bank account. The value begins with `bac`.
      - `name` string — Bank name
      - `fee` number — Estimated bank fees
    - `cards` CardFundingOption[] — Card account options
      - `available` boolean — This field is set as `true` if the funding account is available for vendor payments
      - `deliveryDate` string, date — Vendor payment delivery date. The value is in the `yyyy-MM-dd` format.
      - `processDate` string, date — Vendor payment process date. The value is in the `yyyy-MM-dd` format. On this date, BILL starts processing the payment and starts withdrawing funds from the sender's funding account.
      - `reason` string — Reason why the funding account is not available for vendor payments
      - `conditions` string[] — Additional information required for vendor payments with the funding account
      - `id` string — BILL-generated ID of the card account. The value begins with `cat`.
      - `name` string — Card account name
      - `brand` string — Card brand
      - `feeInfo` object — Estimated card account fees
        - `amount` number — Card fees amount
        - `rate` number — Card fees rate

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