---
title: "Get available train trips"
method: GET
path: "/trips"
tags: ["Trips"]
---

# Get available train trips

`GET /trips`

Returns a list of available train trips between the specified origin and destination stations on the given date, and allows for filtering by bicycle and dog allowances.

## Query parameters

- `page` integer
- `limit` integer
- `origin` string, uuid, required
- `destination` string, uuid, required
- `date` string, date-time, required
- `bicycles` boolean
- `dogs` boolean

## Response `200`

A list of available train trips

- object — This is a generic request/response wrapper which contains both data and links which serve as hypermedia controls (HATEOAS).
  - `data` object[] — The wrapper for a collection is an array of objects.
    - `id` string, uuid — Unique identifier for the trip
    - `origin` string — The starting station of the trip
    - `destination` string — The destination station of the trip
    - `departure_time` string, date-time — The date and time when the trip departs
    - `arrival_time` string, date-time — The date and time when the trip arrives
    - `operator` string — The name of the operator of the trip
    - `price` number — The cost of the trip
    - `bicycles_allowed` boolean — Indicates whether bicycles are allowed on the trip
    - `dogs_allowed` boolean — Indicates whether dogs are allowed on the trip
    - `self` string, uri
  - `links` object — Links to the next and previous pages of a paginated response.
    - `self` string, uri
    - `next` string, uri
    - `prev` string, uri

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/bump-sh-examples/apis/train-travel-api.md) · [All operations](https://skmtc.net/bump-sh-examples/apis/train-travel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bump-sh-examples/train-travel-api/revisions/f98baa492089/schema)