---
title: "Get colony layout"
method: GET
path: "/characters/{character_id}/planets/{planet_id}"
tags: ["Planetary Interaction"]
---

# Get colony layout

`GET /characters/{character_id}/planets/{planet_id}`

Returns full details on the layout of a single planetary colony, including links, pins and routes. Note: Planetary information is only recalculated when the colony is viewed through the client. Information will not update until this criteria is met.

## Path parameters

- `character_id` integer, required
- `planet_id` integer, required — Planet id of the target planet

## Headers

- `Accept-Language` 'en' | 'de' | 'fr' | 'ja' | 'ru' | 'zh' | 'ko' | 'es'
- `If-None-Match` string
- `X-Compatibility-Date` '2025-12-16', date, required
- `X-Tenant` string
- `If-Modified-Since` string

## Response `200`

OK

- CharactersCharacterIdPlanetsPlanetIdGet
  - `links` object[], required
    - `destination_pin_id` integer, required
    - `link_level` integer, required
    - `source_pin_id` integer, required
  - `pins` object[], required
    - `contents` object[]
      - `amount` integer, required
      - `type_id` integer, required
    - `expiry_time` string, date-time
    - `extractor_details` object
      - `cycle_time` integer — in seconds
      - `head_radius` number, double
      - `heads` object[], required
        - `head_id` integer, required
        - `latitude` number, double, required
        - `longitude` number, double, required
      - `product_type_id` integer
      - `qty_per_cycle` integer
    - `factory_details` object
      - `schematic_id` integer, required
    - `install_time` string, date-time
    - `last_cycle_start` string, date-time
    - `latitude` number, double, required
    - `longitude` number, double, required
    - `pin_id` integer, required
    - `schematic_id` integer
    - `type_id` integer, required
  - `routes` object[], required
    - `content_type_id` integer, required
    - `destination_pin_id` integer, required
    - `quantity` number, double, required
    - `route_id` integer, required
    - `source_pin_id` integer, required
    - `waypoints` integer[] — list of pin ID waypoints

## Other responses

- `default` — Error

---

[API](https://skmtc.net/evetech/apis/eve-spring-inebriation-esi-tranquility.md) · [All operations](https://skmtc.net/evetech/apis/eve-spring-inebriation-esi-tranquility/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/evetech/eve-spring-inebriation-esi-tranquility/revisions/780531a22906/schema)