Pular para o conteúdo 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-10-02T10:00:40.864Z",
      "status": "planning",
      "created_by": "4f75d991ac359f8c4c79d762",
      "created_at": "2026-10-02T10:00:40.864Z",
      "updated_at": "2026-10-02T10:00:40.864Z",
      "deleted_at": "2026-10-02T10:00:40.864Z",
      "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

Serviços recorrentes por calendário

Operações que rodam por calendário, não por livro de pedidos. Recargas de gás, vistorias, manutenção de elevadores, serviço de bebedouros, controle de pragas. O mesmo cliente é visitado a cada N semanas aproximadamente no mesmo slot, e o valor que o cliente paga é a confiabilidade do calendário.

Retrieve a plan

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