---
title: "List Waypoints in System"
method: GET
path: "/systems/{systemSymbol}/waypoints"
tags: ["Systems"]
---

# List Waypoints in System

`GET /systems/{systemSymbol}/waypoints`

Return a paginated list of all of the waypoints for a given system.

If a waypoint is uncharted, it will return the `Uncharted` trait instead of its actual traits.

## Path parameters

- `systemSymbol` string, required

## Query parameters

- `page` integer
- `limit` integer
- `type` WaypointTypeJson — unresolved $ref
- `traits` union
  - WaypointTraitSymbolJson — unresolved $ref
  - WaypointTraitSymbolJson[] — unresolved $ref

## Response `200`

Successfully fetched all waypoints in the system.

- object
  - `data` WaypointJson[], required — unresolved $ref
  - `meta` MetaJson, required — unresolved $ref

## Changes

> 50 revisions in range; 2 not diffed.

- **2025-02-06** `a4500b4e7ef1` — 1 breaking
  - added the new path request parameter `systemSymbol`
- **2023-10-28** `6e56b10636d7` — 2 info
  - added the new optional `query` request parameter `traits`
  - added the new optional `query` request parameter `type`
- **2023-06-10** `69f25747ca36` — 1 info
  - the endpoint scheme security `AgentToken` was added to the API
- **2023-06-09** `01114438ccb4` — 2 breaking, 1 info
  - for the `query` request parameter `limit`, default value `10` was added
  - for the `query` request parameter `page`, default value `1` was added
  - the endpoint scheme security `AgentToken` was removed from the API
- **2023-06-09** `735393b679c5` — 2 info
  - api tag `Systems` added
  - api tag `systems` removed

[Full history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/systems/:systemSymbol/waypoints/get.md)

---

[API](https://skmtc.dev/spacetradersapi/apis/spacetraders-api.md) · [All operations](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacetradersapi/spacetraders-api/revisions/197cf9b9a2b6/schema)