---
title: "Starmap Celestial Objects Overview"
method: GET
path: "/api/celestial-objects"
tags: ["Starmap", "RSI-Website"]
---

# Starmap Celestial Objects Overview

`GET /api/celestial-objects`

Returns paginated celestial objects with optional relationships.

## Query parameters

- `page` integer
- `page[number]` integer
- `page[size]` integer
- `filter[starsystem]` string
- `filter[name]` string
- `filter[designation]` string
- `filter[type]` string
- `sort` string
- `include` string

## Response `200`

List of Celestial Objects

- CelestialObject[]
  - `id` integer
  - `code` string
  - `system_id` integer
  - `celestial_object_api_url` string
  - `web_url` string
  - `name` string
  - `type` string
  - `age` integer
  - `habitable` boolean
  - `fairchanceact` boolean
  - `appearance` string
  - `designation` string
  - `distance` number, float
  - `latitude` number, float
  - `longitude` number, float
  - `axial_tilt` number, float
  - `orbit_period` number, float
  - `info_url` string
  - `description` object
  - `sensor` object
    - `population` number, float
    - `economy` number, float
    - `danger` number, float
  - `size` number, float
  - `parent_id` integer
  - `starsystem` object, nullable
    - `id` integer, nullable
    - `code` string, nullable
    - `name` string, nullable
  - `time_modified` string

## Changes

- **2026-03-29** `8ff40d443bb4` — 1 breaking, 3 warning, 2 info
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `links` from the response with the `200` status
  - removed the optional property `meta` from the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/celestial-objects/get.md)

---

[API](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/starcitizenwiki/star-citizen-wiki-api/revisions/e25ade3eea2f/schema)