# 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.



## Servers
- Mock Server: https://try.microcks.io/rest/Train+Travel+API/1.0.0 (Mock Server)
- Production: https://api.example.com (Production)


## Authentication methods
- O auth2


## Parameters


#### Query parameters
- **page** (integer)
  The page number to return
- **limit** (integer)
  The number of items to return per page
- **origin** (string(uuid))
  The ID of the origin station
- **destination** (string(uuid))
  The ID of the destination station
- **date** (string(date-time))
  The date and time of the trip in ISO 8601 format in origin station's timezone.
- **bicycles** (boolean)
  Only return trips where bicycles are known to be allowed
- **dogs** (boolean)
  Only return trips where dogs are known to be allowed


## Responses
### 200: A list of available train trips
#### Headers
- **Cache-Control** (string)
  A comma-separated list of directives as defined in [RFC 9111](https://www.rfc-editor.org/rfc/rfc9111.html).
- **RateLimit** (string)
  The RateLimit header communicates quota policies. It contains a `limit` to
convey the expiring limit, `remaining` to convey the remaining quota units,
and `reset` to convey the time window reset time.


#### Body Parameters: application/json (object)
- **data** (array[object])
  The wrapper for a collection is an array of objects.
- **links** (object)
  Links to the next and previous pages of a paginated response.

### 400: Bad Request
#### Headers
- **RateLimit** (string)
  The RateLimit header communicates quota policies. It contains a `limit` to
convey the expiring limit, `remaining` to convey the remaining quota units,
and `reset` to convey the time window reset time.


#### Body Parameters: application/problem+json (object)
- **type** (string)
  A URI reference that identifies the problem type
- **title** (string)
  A short, human-readable summary of the problem type
- **detail** (string)
  A human-readable explanation specific to this occurrence of the problem
- **instance** (string)
  A URI reference that identifies the specific occurrence of the problem
- **status** (integer)
  The HTTP status code

### 401: Unauthorized
#### Headers
- **RateLimit** (string)
  The RateLimit header communicates quota policies. It contains a `limit` to
convey the expiring limit, `remaining` to convey the remaining quota units,
and `reset` to convey the time window reset time.


#### Body Parameters: application/problem+json (object)
- **type** (string)
  A URI reference that identifies the problem type
- **title** (string)
  A short, human-readable summary of the problem type
- **detail** (string)
  A human-readable explanation specific to this occurrence of the problem
- **instance** (string)
  A URI reference that identifies the specific occurrence of the problem
- **status** (integer)
  The HTTP status code

### 403: Forbidden
#### Headers
- **RateLimit** (string)
  The RateLimit header communicates quota policies. It contains a `limit` to
convey the expiring limit, `remaining` to convey the remaining quota units,
and `reset` to convey the time window reset time.


#### Body Parameters: application/problem+json (object)
- **type** (string)
  A URI reference that identifies the problem type
- **title** (string)
  A short, human-readable summary of the problem type
- **detail** (string)
  A human-readable explanation specific to this occurrence of the problem
- **instance** (string)
  A URI reference that identifies the specific occurrence of the problem
- **status** (integer)
  The HTTP status code

### 429: Too Many Requests
#### Headers
- **RateLimit** (string)
  The RateLimit header communicates quota policies. It contains a `limit` to
convey the expiring limit, `remaining` to convey the remaining quota units,
and `reset` to convey the time window reset time.

- **Retry-After** (string)
  The Retry-After header indicates how long the user agent should wait before making a follow-up request. 
The value is in seconds and can be an integer or a date in the future. 
If the value is an integer, it indicates the number of seconds to wait. 
If the value is a date, it indicates the time at which the user agent should make a follow-up request. 


#### Body Parameters: application/problem+json (object)
- **type** (string)
  A URI reference that identifies the problem type
- **title** (string)
  A short, human-readable summary of the problem type
- **detail** (string)
  A human-readable explanation specific to this occurrence of the problem
- **instance** (string)
  A URI reference that identifies the specific occurrence of the problem
- **status** (integer)
  The HTTP status code

### 500: Internal Server Error
#### Headers
- **RateLimit** (string)
  The RateLimit header communicates quota policies. It contains a `limit` to
convey the expiring limit, `remaining` to convey the remaining quota units,
and `reset` to convey the time window reset time.


#### Body Parameters: application/problem+json (object)
- **type** (string)
  A URI reference that identifies the problem type
- **title** (string)
  A short, human-readable summary of the problem type
- **detail** (string)
  A human-readable explanation specific to this occurrence of the problem
- **instance** (string)
  A URI reference that identifies the specific occurrence of the problem
- **status** (integer)
  The HTTP status code


[Powered by Bump.sh](https://bump.sh)