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

# 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`

Paginated list of Celestial Objects

- object
  - `data` 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
  - `links` PaginationLinks — Pagination navigation links.
    - `first` string, nullable — URL to the first page.
    - `last` string, nullable — URL to the last page.
    - `prev` string, nullable — URL to the previous page.
    - `next` string, nullable — URL to the next page.
  - `meta` PaginationMeta — Pagination metadata.
    - `current_page` integer — Current page number.
    - `from` integer — Index of the first item in this page.
    - `last_page` integer — Last available page number.
    - `per_page` integer — Number of items per page.
    - `to` integer — Index of the last item in this page.
    - `total` integer — Total number of items across all pages.
    - `links` object[] — Pagination navigation links with page URLs.
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string — Base URL path for pagination.

## Changes

> 50 revisions in range; 1 could not be searched.

- **2026-05-21** `af03a6ba771d` — 1 breaking, 5 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - api operation id `cb1abb65b355a5cbf26f23c3b231a676` removed and replaced with `listCelestialObjects`
  - api tag `RSI-Website` removed
  - added the optional property `data` to the response with the `200` status
  - …2 more
- **2026-03-29** `8ff40d443bb4` — 1 breaking, 3 warning, 2 info
  - the response's body type/format 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/8b259bb9a44c/schema)