List Vendors
Retrieve a list of vendors/customers with optional filtering and sorting.
Each vendor includes metadata about its parent vendor (parent, parent_name) and its
full lineage (the ordered chain of ancestor vendors), so parent/child vendor
relationships can be reconstructed from the response.
Supports retrieving deleted records for audit purposes. When include_deleted=true, returns ONLY deleted records with minimal data (id, is_deleted, deleted_at, last_modified_at). When false or omitted, returns ONLY active records.
Authorizations
Token-based authentication with required prefix "Token"
Query Parameters
Filter by external ID
When set to 'true', returns ONLY deleted records instead of active records. Deleted records contain minimal data: 'id', 'is_deleted=true', 'deleted_at' timestamp, and 'last_modified_at'. When 'false' or omitted, returns ONLY active records. This provides clean separation between active and deleted data.
Include inactive vendors in results
Filter for records modified on or after this timestamp. Format: ISO 8601 (e.g., '2024-01-01T00:00:00Z' or '2024-01-01'). Works with both active records and deleted records (filters by deletion time for deleted records).
Filter for records modified on or before this timestamp. Format: ISO 8601 (e.g., '2024-12-31T23:59:59Z' or '2024-12-31'). Works with both active records and deleted records (filters by deletion time for deleted records).
Number of results to return per page.
The initial index from which to return the results.
Search query - searches by name, DBA, email, or company name. If numeric, also searches by ID
Sort order. Use field name for ascending, -field for descending. Supports multiple fields separated by comma. Default: name
Filter by vendor type. Can be specified multiple times for multiple types
customer, vendor