---
canonical_url: "https://docs.composio.dev/toolkits/sncf"
markdown_url: "https://docs.composio.dev/toolkits/sncf.md"
product: "platform"
version: null
last_updated: null
---

# SNCF

Access SNCF passenger-information data for train journeys, stations, schedules, service status, and transport-network discovery.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `SNCF`
- **Version:** 00000000_00

## Tools

### Find Nearby Places

**Slug:** `SNCF_FIND_NEARBY_PLACES`

Find SNCF stations, stops, or points of interest near a geographic coordinate.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum results in this page. |
| `latitude` | number | Yes | WGS84 latitude from -90 to 90. |
| `longitude` | number | Yes | WGS84 longitude from -180 to 180. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `place_type` | string ("stop_area" | "stop_point" | "poi") | No | Single nearby object type; stop_area represents passenger stations. |
| `distance_meters` | integer | No | Positive search radius in metres. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Service Status

**Slug:** `SNCF_GET_SERVICE_STATUS`

Get SNCF network service disruptions and affected lines, stations, or vehicle journeys for a time window. Returns one page; pass next_cursor back to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `depth` | integer | No | Affected-object expansion depth from 0 to 3. |
| `limit` | integer | No | Reports per page. |
| `since` | string | No | Beginning of the disruption window in compact YYYYMMDDTHHMMSS format. |
| `until` | string | No | End of the disruption window in compact YYYYMMDDTHHMMSS format. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `next_cursor` | string | No | Opaque continuation returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Station Board

**Slug:** `SNCF_GET_STATION_BOARD`

Get upcoming departures or arrivals for an SNCF station, including scheduled and realtime times and disruption context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum station-board entries to request. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `board_type` | string ("departures" | "arrivals") | No | Whether to return trains leaving or reaching the station. |
| `station_id` | string | Yes | A stop_area station ID returned by SNCF_SEARCH_PLACES. |
| `from_datetime` | string | No | Start of the local time window in compact YYYYMMDDTHHMMSS format. |
| `data_freshness` | string ("realtime" | "base_schedule") | No | Use realtime for live running information or base_schedule for planned times. |
| `direction_type` | string ("all" | "forward" | "backward") | No | Optional direction grouping filter. |
| `duration_seconds` | integer | No | Time window in seconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transport Object

**Slug:** `SNCF_GET_TRANSPORT_OBJECT`

Get details for one SNCF network, line, route, station, stop, mode, company, or vehicle journey by canonical ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `depth` | integer | No | Related-object expansion depth from 0 to 3. |
| `object_id` | string | Yes | Canonical ID returned by SNCF search or list tools. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `collection` | string ("networks" | "lines" | "routes" | "stop_points" | "stop_areas" | "commercial_modes" | "physical_modes" | "companies" | "vehicle_journeys") | Yes | Whitelisted collection containing the object. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SNCF Coverage

**Slug:** `SNCF_LIST_COVERAGE`

Get the SNCF transport-data coverage region and its current production horizon.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transport Objects

**Slug:** `SNCF_LIST_TRANSPORT_OBJECTS`

Browse one supported SNCF transport-object collection, such as lines, networks, routes, stations, or vehicle journeys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `depth` | integer | No | Related-object expansion depth from 0 to 3. |
| `limit` | integer | No | Items per page. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `collection` | string ("networks" | "lines" | "routes" | "stop_points" | "stop_areas" | "commercial_modes" | "physical_modes" | "companies" | "vehicle_journeys") | Yes | Whitelisted collection to browse; stop_areas are passenger stations. |
| `next_cursor` | string | No | Opaque continuation returned by a previous call; omit for the first page. |
| `data_freshness` | string ("realtime" | "base_schedule") | No | Optional schedule source, mainly useful for vehicle_journeys. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Plan Journey

**Slug:** `SNCF_PLAN_JOURNEY`

Plan SNCF train journeys between two station/place IDs or coordinates for a requested departure or arrival time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datetime` | string | No | Local journey time in compact YYYYMMDDTHHMMSS format, interpreted in the region timezone. |
| `to_place` | string | Yes | Destination place ID from SNCF_SEARCH_PLACES, or WGS84 'longitude;latitude'. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `from_place` | string | Yes | Origin place ID from SNCF_SEARCH_PLACES, or WGS84 'longitude;latitude'. |
| `wheelchair` | boolean | No | Request wheelchair-accessible journey constraints when true. |
| `max_journeys` | integer | No | Maximum journey options to request (1-20). |
| `max_transfers` | integer | No | Optional maximum number of transfers (0-10). |
| `traveler_type` | string ("standard" | "slow_walker" | "fast_walker" | "luggage" | "wheelchair") | No | Traveler profile used for walking and transfer calculations. |
| `data_freshness` | string ("realtime" | "base_schedule") | No | Use realtime for current operations or base_schedule for the published timetable. |
| `datetime_represents` | string ("departure" | "arrival") | No | Whether datetime is the desired departure or arrival time. |
| `max_duration_seconds` | integer | No | Optional maximum total journey duration in seconds (60-172800). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Places

**Slug:** `SNCF_SEARCH_PLACES`

Find SNCF stations, addresses, administrative areas, or points of interest by name and return IDs usable for journeys and station boards.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `near` | string | No | Optional WGS84 'longitude;latitude' used only to rank results by proximity. |
| `depth` | integer | No | Related-object expansion depth from 0 to 3. |
| `limit` | integer | No | Maximum number of autocomplete results to request. |
| `query` | string | Yes | Place or station name to search for, such as 'Paris Gare de Lyon'. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `place_type` | string ("stop_area" | "address" | "administrative_region" | "poi") | No | Single result type to return; stop_area is the best choice for train stations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Transport Objects

**Slug:** `SNCF_SEARCH_TRANSPORT_OBJECTS`

Search SNCF networks, modes, lines, routes, stations, or stop points by name and return canonical transport-object IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `depth` | integer | No | Related-object expansion depth from 0 to 3. |
| `query` | string | Yes | Name or code to autocomplete. |
| `region_id` | string | No | Coverage region; use 'sncf' for the SNCF passenger network. |
| `object_type` | string ("network" | "commercial_mode" | "line" | "route" | "stop_area" | "stop_point") | No | Optional single transport-object type to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |