---
title: "List a vendor's open Payables bills that a vendor bill can post"
method: GET
path: "/accountant/companies/{customerId}/business-events/vendor-bill-candidates"
tags: ["Accountant Portal"]
---

# List a vendor's open Payables bills that a vendor bill can post

`GET /accountant/companies/{customerId}/business-events/vendor-bill-candidates`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/business-events/vendor-bill-candidates`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Read-only pick list for the accountant vendor-bill form (#2741). Returns the customer's open Payables bills for the named vendor (case- and whitespace-insensitive name match) in the primary entity's functional currency that have no posting source yet: no journal entry, no source business event and no bill document. Pass a returned id as `parameters.apItemId` on the `vendor_bill` business event to post that bill instead of creating a second one. Void, paid and already-posted bills are never returned.

## Query parameters

- `vendor` string, required

## Response `200`

Candidate bills, newest bill date first

- object
  - `success` true, required
  - `data` object, required
    - `candidates` object[], required
      - `id` string, uuid, required
      - `vendor` string, required
      - `amountCents` integer, required: Bill amount in integer minor units.
      - `currency` string, required
      - `issueDate` string, date, required
      - `dueDate` string, date, nullable, required
      - `billNumber` string, nullable, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `422`: Request failed validation

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)