---
title: "Which major corridors have the most going on right now."
method: GET
path: "/v1/tools/rank_routes"
---

# Which major corridors have the most going on right now.

`GET /v1/tools/rank_routes`

## Request

- Base URL: `https://mcp.commutescout.com`
- URL: `https://mcp.commutescout.com/v1/tools/rank_routes`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

Which major corridors have the most going on right now.

    Answers broad questions like "what are the busiest routes", "where is
    traffic worst", or "which highways should I avoid today" across all 17
    tracked corridors. by="activity" ranks on live events (full closures
    weigh most, then incidents, lane closures, chain controls);
    by="congestion" ranks on measured speed vs free-flow at each
    corridor's midpoint and needs the traffic feed to be configured -
    if it is not, the ranking silently falls back to activity.

    Each entry carries the counts and a one-line reason, so the answer
    can say WHY a corridor ranks where it does, not just list names.

## Query parameters

- `by` string
- `limit` integer

## Response `200`

The tool's result.

- object

## Other responses

- `400`: A parameter is missing, unknown or malformed.
- `401`: The API key is unknown or revoked.
- `429`: Slow down; Retry-After says how long.

---

[API](https://skmtc.dev/commutescout/apis/commutescout-api.md) · [All operations](https://skmtc.dev/commutescout/apis/commutescout-api/llms.txt) · [OpenAPI document](https://skmtc.dev/commutescout/apis/commutescout-api/revisions/70427a609edf?raw)