List Companies
hudu_list_companiesList companies in Hudu, filtering by name, search, city, state, and more. Paginate through results to retrieve complete data with pagination details.
Instructions
List companies in Hudu. A company is the top-level container in Hudu; every asset, article, password and website belongs to exactly one.
To find a company by name, prefer search (matches broadly) over name (matches the name field). If the API key was created with a company scope, only that company is visible here and everything else returns 404.
Returns an object with items plus pagination facts. Note that the Hudu API returns no total count for any collection, so page_was_full is the only honest signal that more records exist — read pagination_note before concluding a list is complete.
Operation class: Read.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| name | No | Match against the company name specifically. | |
| page | No | 1-based page number. Hudu has no cursor or offset — only pages. | |
| slug | No | URL slug, if you already know it. | |
| state | No | ||
| fields | No | Return only these top-level fields on each record. Use it to keep large lists small — e.g. ["id","name","company_id"]. Unknown field names are ignored. | |
| search | No | Broad text search across company fields. The best first filter for a name. | |
| website | No | ||
| id_number | No | Your own external identifier. | |
| page_size | No | Records per page (1-100, default 25). Hudu publishes no maximum, so this client clamps at 100; larger values are rejected here rather than silently altered by the server. | |
| updated_at | No | ISO-8601 range as "start,end". Either side may be omitted — "2026-01-01T00:00:00Z," means everything changed since that moment. | |
| phone_number | No | ||
| response_format | No | Output shape. 'json' (default) is compact and machine-readable; 'markdown' is easier for a person to read but larger. | json |
| id_in_integration | No | Match a company by its id inside a connected integration (PSA, RMM). |