A page of suppliers with their terms, lead times and delivery record
A page of suppliers: identity and address, currency, minimum order value, the resolved lead time and where it came from, the primary contact, the per-warehouse lead times, and the OTIF, on-time and in-full rates. filtered_max_size is the size of the filtered set and max_size the size of the book, so a client can page without counting.
Page with limit (1 to 10,000, default 10) and offset (0 to 2,147,483,647). Narrow with filter_args, a JSON array of {key, operation, value, group}, on id, name, city, country and currency (eq, in), min_order_value and lead_time (gte, lte), is_archived (eq) and missing_fields (eq, in). Order with sort_args, comma-separated, - for descending, over id, name, city, country, postal_code, min_order_value, lead_time, otif_score, on_time, in_full and primary_contact.name, .email and .phone. search matches the name and the address.
A row's lead_time resolves the supplier's own figure against the organisation default, while each entry in location_lead_times resolves that warehouse's override against the same default. The two can differ on one row on purpose. otif_score, on_time and in_full are null until enough delivery lines have been scored to publish a rate.
A row carries no contacts list and no lanes. get_supplier_details is the whole record for one supplier.
Scope: suppliers:read.
Request
- Base URL: https://api.app.tightly.io
- URL: https://api.app.tightly.io/api/v1/inventory/suppliers/table
- Auth: HTTP bearer
Query parameters
Return filtered_max_size and max_size without rows, delivery scoring or warehouse enrichment. size is zero and rows is empty. Counts ignore offset and limit; offset is echoed. max_size remains the full supplier-book count even when no supplier matches the filters. Cannot be combined with for_zapier. Defaults to the existing full table response.
Rows per page. Out of range is refused 400.
Rows to skip. Out of range is refused 400.
A JSON array of filter conditions, each {key, operation, value} with an optional group of and (the default) or or. Keys and their operations: id, name, city, country, currency (eq, in); min_order_value, lead_time (gte, lte); is_archived (eq, true or false); missing_fields (eq, in), suppliers with nothing on file for a field, whose value is one of name, city, country, postal_code, currency, min_order_value, lead_time, contact_name, contact_email, contact_phone. missing_fields groups as or unless you say otherwise, because asking for two missing fields almost always means either. An unsupported key, operation or value is refused 400 naming what was allowed.
Comma-separated sort columns, - for descending and + or nothing for ascending. Valid columns: id, name, city, country, postal_code, min_order_value, lead_time, otif_score, on_time, in_full, primary_contact.name, primary_contact.email, primary_contact.phone.
Free text matched against the supplier's name and address.
Headers
The date train to answer on. One train exists today, 2026-11, the one this reference describes and the one every key is minted on, so the call answers on it with or without this header. Send it anyway, so a client built now names its train from the start.
Response
One page of supplier rows, with the offset requested, the number of rows served, the size of the filtered set and the size of the whole book.
Changes
No recorded changes to this operation across all 1 revision of this API.