---
title: "Listar rutas"
method: GET
path: "/routes"
tags: ["Routes"]
---

# Listar rutas

`GET /routes`

## Request

- Base URL: `https://mi-organizacion.routes.zipnova.app/api/v1`
- URL: `https://mi-organizacion.routes.zipnova.app/api/v1/routes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zipnova/apis/zipnova-rutas-api-organizacional/docs/routes/get.ts> (a function with typed inputs; its response is checked against the schema)

Retorna un listado paginado de rutas de la organización. Por defecto excluye rutas en estado `draft` y `finished`.

## Query parameters

- `status` union
  - 'draft' | 'published' | 'blocked' | 'started' | 'finished'
  - string[]
- `created_from` string, date-time
- `created_to` string, date-time

## Response `200`

Lista paginada de rutas

- object
  - `routes` object
    - `data` RouteSummary[]
      - `id` integer
      - `external_id` string, nullable
      - `shift_date` string, date
      - `status` string
      - `driver` object, nullable
        - `id` integer
        - `firstname` string
        - `lastname` string
      - `vehicle` object, nullable
        - `id` integer
        - `name` string
      - `created_at` string, date-time
    - `links` object
      - `first` string, uri, nullable
      - `last` string, uri, nullable
      - `prev` string, uri, nullable
      - `next` string, uri, nullable
    - `meta` Pagination: Metadatos de paginación
      - `total` integer: Total de registros.
      - `per_page` integer: Registros por página.
      - `current_page` integer: Página actual.
      - `last_page` integer: Última página.
      - `from` integer: Índice del primer registro de la página.
      - `to` integer: Índice del último registro de la página.

## Other responses

- `401`: No autenticado
- `403`: Sin permisos

---

[API](https://skmtc.dev/zipnova/apis/zipnova-rutas-api-organizacional.md) - [All operations](https://skmtc.dev/zipnova/apis/zipnova-rutas-api-organizacional/llms.txt) - [OpenAPI document](https://skmtc.dev/zipnova/apis/zipnova-rutas-api-organizacional/revisions/d57b2ae4ce92?raw)