A page of supplier contacts, with the supplier each belongs to
A page of contacts across every supplier: name, email, phone, city, country, role, department, preferred contact method, the supplier each belongs to by id and name, and is_primary_contact. filtered_max_size is the size of the filtered set and max_size the size of the book.
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 role, country, city, supplier_id and department (eq, in), preferred_contact_method (eq) and missing_fields (eq, in). Order with sort_args, comma-separated, - for descending, over name, country, city, role, supplier_name, department, email and preferred_contact_method. search matches the name and the email.
preferred_contact_method is email or phone and is never null: a contact with neither recorded reads email. supplier_id and supplier_name are null for a contact attached to no supplier, a contact created against a wholesale account rather than a supplier is one such.
Ask get_contacts_filters for the values these filters can take rather than guessing them.
Scope: suppliers:read.
Request
- Base URL: https://api.app.tightly.io
- URL: https://api.app.tightly.io/api/v1/contacts/table
- Auth: HTTP bearer
Query parameters
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: role, country, city, supplier_id, department (eq, in); preferred_contact_method (eq); missing_fields (eq, in), contacts with nothing on file for a field, whose value is one of email, phone, city, country, description, department, role, supplier, preferred_contact_method. 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: name, country, city, role, supplier_name, department, email, preferred_contact_method.
Free text matched against the contact's name and email.
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 contacts, 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.