---
title: "get stations · RUAL Documentation"
description: "List or search NS stations. Leave the search empty to retrieve all stations."
canonical: https://docs.rual.nl/block-types/NS/nsconnection_stations
language: en
---

# get stations

This block is part of the [`NS`](https://docs.rual.nl/block-types/NS) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

List or search NS stations. Leave the search empty to retrieve all stations.

- flow `flow`

- Connection required `nsconnection` The NS connection.

- Search `value` Optional search text to filter stations by name.

- Country codes `value` Optional comma-separated country codes to filter on (e.g. nl,be,de).

- Limit `number` Maximum number of stations to return (only applied together with a search).

- flow `flow`

- Connection `nsconnection` The NS connection.

- Success `condition` True if the request succeeded.

- Stations `array` The matching stations, each with name, code, uic_code, country and a ready-to-use geo_point.

- Count `number` Number of stations returned.

- Error `value` Error message if the request failed.

| `stations` |
| --- |
| `stationslijst` |

A typical wiring for [get stations](https://docs.rual.nl/block-types/NS/nsconnection_stations): [branch](https://docs.rual.nl/block-types/flow/branch) feeds the `flow` pin; [open connection](https://docs.rual.nl/block-types/NS/nsconnection_open) feeds the `connection` pin; the `flow` out pin feeds [foreach](https://docs.rual.nl/block-types/foreach/function_foreach).

![Studio canvas example for the get stations block: typical wiring for get stations.](https://docs.rual.nl/canvas-examples/nsconnection_stations.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [foreach](https://docs.rual.nl/block-types/foreach/function_foreach): this block feeds into it.

- [branch](https://docs.rual.nl/block-types/flow/branch): feeds into this block.

- [open connection](https://docs.rual.nl/block-types/NS/nsconnection_open): feeds into this block. Open a connection with the NS (Nederlandse Spoorwegen) Reisinformatie API. Reuse the resulting connection in the other NS blocks.

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).