# Get a list of train stations

Returns a list of all train stations in the system.

Endpoint: GET /stations
Version: 1.0.0
Security: OAuth2

## Response 200 fields (application/json):

  - `data` (array)
    The wrapper for a collection is an array of objects.

  - `data.id` (string, required)
    Unique identifier for the station.

  - `data.name` (string, required)
    The name of the station

  - `data.address` (string, required)
    The address of the station.

  - `data.country_code` (string, required)
    The country code of the station.

  - `data.timezone` (string)
    The timezone of the station in the [IANA Time Zone Database format](https://www.iana.org/time-zones).

  - `links` (object)
    A set of hypermedia links which serve as controls for the client.

  - `links.self` (string)

  - `links.next` (string)

  - `links.prev` (string)

## Response 400 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type
    Example: "https://example.com/probs/out-of-credit"

  - `title` (string)
    A short, human-readable summary of the problem type
    Example: "You do not have enough credit."

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Your current balance is 30, but that costs 50."

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/account/12345/msgs/abc"

  - `status` (integer)
    The HTTP status code
    Example: 400

## Response 401 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type
    Example: "https://example.com/probs/out-of-credit"

  - `title` (string)
    A short, human-readable summary of the problem type
    Example: "You do not have enough credit."

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Your current balance is 30, but that costs 50."

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/account/12345/msgs/abc"

  - `status` (integer)
    The HTTP status code
    Example: 400

## Response 403 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type
    Example: "https://example.com/probs/out-of-credit"

  - `title` (string)
    A short, human-readable summary of the problem type
    Example: "You do not have enough credit."

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Your current balance is 30, but that costs 50."

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/account/12345/msgs/abc"

  - `status` (integer)
    The HTTP status code
    Example: 400

## Response 429 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type
    Example: "https://example.com/probs/out-of-credit"

  - `title` (string)
    A short, human-readable summary of the problem type
    Example: "You do not have enough credit."

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Your current balance is 30, but that costs 50."

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/account/12345/msgs/abc"

  - `status` (integer)
    The HTTP status code
    Example: 400

## Response 500 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type
    Example: "https://example.com/probs/out-of-credit"

  - `title` (string)
    A short, human-readable summary of the problem type
    Example: "You do not have enough credit."

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Your current balance is 30, but that costs 50."

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/account/12345/msgs/abc"

  - `status` (integer)
    The HTTP status code
    Example: 400