Material vendors
Retrieve a bounded Company-qualified directory of active material vendors without accepting a Company selector.
List the represented Company's vendors
GET /v1/vendors lists material vendors attached to the represented Company's account. The Company is derived from authenticated caller context; org_id is not accepted as a public query parameter.
- The operation has no status query parameter; only active vendors are returned.
- The directory is limited to 50 vendors with no paging. A directory that would exceed the limit fails instead of being truncated.
- Current Enterprise authority is required. Direct-Company caller context only; partner-application access is not supported.
- vendor_skey is an opaque stable vendor reference for the vendor accounts operation and is not required to be a UUID.
Use vendor facts as data, not authority
Vendor status, type, address, contact, logo, branch-location text, account count, and transaction-pipeline availability describe the current directory entry. They do not authorize transactions or grant access to vendor accounts, pricing, quotes, or contacts beyond the returned representation.
- transaction_pipeline_available means the vendor can participate in the HPH transaction pipeline; it is not a promise that a particular transaction will succeed.
- branch_location is human-readable text and is not a stable branch identifier.
- code is nullable when the Company has not assigned a vendor code.
- Vendor accounts use a separate operation and are never flattened into duplicate vendor rows.
List active vendor accounts
GET /v1/vendors/{vendor_skey}/accounts returns active accounts for one vendor that belongs to the represented Company. The Company-vendor relationship is enforced on every request; calling the vendor list first is not required and grants nothing.
- A valid vendor with no active accounts returns an empty accounts array.
- Unknown and foreign-company vendor references are concealed identically.
- account_number is a permitted nullable public field.
- The collection is limited to 50 accounts with no paging and fails instead of being truncated.
- Only active accounts are returned, so the public account object does not carry a status field.