List Company Vendors
list_company_vendorsRetrieve all vendors for a company. Use the minimal view for lightweight dropdown data without extra permissions, or look up a vendor ID before making other Procore API calls.
Instructions
Return a list of all Vendors associated with a Company. Adds support for the minimal view, which returns a reduced payload (id, name, is_active, logo) intended for vendor selector dropdowns. The minimal view does not require the view_vendors Directory permission — it is available to any user authenticated on the Company. All other views continue to require view_vendors. Use this to discover company vendors or to look up the id of one before calling a tool that needs it. Returns a JSON array of company vendors; page and per_page control pagination and the response reports how many pages remain. Read-only — it changes nothing in Procore. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id. Procore API (v1.1): Core > Directory. Endpoint: GET /rest/v1.1/vendors
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| sort | No | Query string parameter — return items with the specified sort | |
| view | No | Query string parameter — specifies which view of the resource to return (which attributes should be present in the response). The `minimal` view returns a reduced payload and does not require Directory permissions; all oth... | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| company_id | Yes | Query string parameter — unique identifier for the company. | |
| filters__id__ | No | Query string parameter — returns vendors with the specified id(s) | |
| filters__search | No | Query string parameter — return vendors where the search string matches the vendor name, keywords, origin_code, or ABN/EIN number | |
| filters__origin_id | No | Query string parameter — origin ID. Returns item(s) with the specified Origin ID. | |
| filters__created_at | No | Query string parameter — return items within a specific created at ISO8601 datetime range | |
| filters__trade_id__ | No | Query string parameter — returns vendors associated with the specified trade id(s) | |
| filters__updated_at | No | Query string parameter — return items within a specific updated at ISO8601 datetime range | |
| filters__parent_id__ | No | Query string parameter — returns vendors with the specified parent id(s) | |
| filters__standard_cost_code_id__ | No | Query string parameter — returns vendors associated with the specified standard cost code id(s) |