Blackbee AI icon

Blackbee AI

Interact with the Blackbee AI Accounts-Payable API

Actions6

Vendor → Get List

AI-generated

Summary

Fetches a paginated list of vendors from the Blackbee AI Accounts-Payable API. Optionally filter by vendor risk, spend, search term, IDs, statuses, or types, and set sorting.

Inputs

  • Page — 1-based page number to fetch; defaults to 1.
  • Count — Number of vendors per page; defaults to 25.
  • Risk — Optional minimum and maximum vendor risk score (0–100).
  • Search Term — Free-text search across vendor name and code.
  • Sort Field — Field to sort by; defaults to createdAt.
  • Sort Order — Ascending (ASC) or descending (DESC); defaults to ascending.
  • Total Spend — Optional minimum and maximum total spend range, in base currency.
  • Vendor IDs — Optional list of vendor IDs to include.
  • Vendor Statuses — Optional statuses to include: Active, Awaiting Approval, Draft, Inactive, or Rejected.
  • Vendor Type Names or IDs — Optional vendor types to include; choose from the loaded list or provide IDs using an expression.

Output shape

A list response from the vendor list endpoint, returned as n8n output items.

Sends a POST request to /ap-api/vendor/list with pagination, filters, and sorting in the request body. The request also includes isFirstLoad: true, isPagination: true, fields: [], and dateFormat: MM/DD/YYYY. The response is paginated; use Page and Count to select the requested page and page size.

Links

Discussion