---
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.

---

[API](https://skmtc.net/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.net/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starcitizenwiki/star-citizen-wiki-api/versions/8b259bb9a44c/schema)