Find paths between two companies
find_paths_betweenEvery documented supply path between two companies, following supplier->customer edges (e.g. 'how does NVIDIA actually depend on Shin-Etsu'). Searches up to max_depth hops in one or both directions and returns each path as an ordered list of companies, shortest first. Capped for combinatorial safety; absence of a path means undocumented, not disproven — see edge_coverage.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Target company id, name, or ticker. | |
| from | Yes | Starting company id, name, or ticker. | |
| limit | No | Max number of paths to return (1-50, default 10). | |
| direction | No | 'downstream': paths where `from` supplies (directly or via intermediaries) to `to`. 'upstream': paths where `from` depends on `to` as a supplier. 'either': search both directions and label each path. | either |
| max_depth | No | Maximum path length in hops (edges). Default 3, hard-capped at 4 to bound the search. |