Saltar al contenido principal
Routal
API ReferencePlan

List plans

Returns a paginated list of the project's plans, filterable by date range, status or label.

GET
/v2/plans

Returns a paginated list of the project's plans, filterable by date range, status or label.

Authorization

api_key
private_key<token>

Pass your API key as the private_key query string parameter. Generate and rotate keys in Developer Settings of your Routal workspace.

Keys stay server-side. Never ship them to a browser or mobile app.

In: query

Query Parameters

text?string

Search string

sort?string

Sort columns

offset?number

Number of plans to skip

Default0
limit?number

Number of plans to fetch

Default20
deleted?boolean

with deleted plans

Defaultfalse
project_id?string

Plan project ID

Match^[0-9a-f]{24}
status?string

Plan status

Value in"planning" | "in_progress" | "finished" | "draft"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/plans"
{
  "total": 1000,
  "limit": 50,
  "offset": 25,
  "pages": 20,
  "page": 1,
  "docs": [
    {
      "id": "4f75d991ac359f8c4c79d762",
      "organization_id": "4f75d991ac359f8c4c79d762",
      "project_id": "4f75d991ac359f8c4c79d762",
      "completed_stops": 1,
      "canceled_stops": 2,
      "pending_stops": 3,
      "incomplete_stops": 3,
      "total_stops": 6,
      "total_routes": 5,
      "label": "Eixample route — 2026-05-21",
      "execution_date": "2026-09-09T07:20:39.214Z",
      "status": "planning",
      "created_by": "4f75d991ac359f8c4c79d762",
      "created_at": "2026-09-09T07:20:39.214Z",
      "updated_at": "2026-09-09T07:20:39.214Z",
      "deleted_at": "2026-09-09T07:20:39.214Z",
      "deleted": true
    }
  ]
}
{
  "message": "Domain not found",
  "message_id": "highway.domain.error.not_found"
}
Empty
{
  "message": "Domain not found",
  "message_id": "highway.domain.error.not_found"
}
{
  "message": "Domain not found",
  "message_id": "highway.domain.error.not_found"
}
Empty
Empty

Servicios recurrentes por calendario

Operaciones que corren por calendario, no por libro de pedidos. Recargas de butano, inspecciones ITV, mantenimiento de ascensores, servicio de fuentes de agua, control de plagas. El mismo cliente se visita cada N semanas aproximadamente en el mismo slot, y el valor que el cliente paga es la fiabilidad del calendario.

Retrieve a plan

Returns the full plan: its routes, stops, vehicles and metadata.