# Get all planets

`GET /planets`

It's easy to say you know them all, but do you really? Retrieve all the planets and check whether you missed one.

Base URL: https://galaxy.scalar.com, https://void.scalar.com/

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | no | The number of items to return |
| `offset` | query | integer | no | The number of items to skip before starting to collect the result set |

## Responses

### 200: OK

- `data` (array<Planet>)
- `meta` (object)
  - `limit` (integer)
  - `offset` (integer)
  - `total` (integer)
  - `next` (string | null)

```json
{
  "data": [
    {
      "id": 1,
      "name": "Mars",
      "description": "The red planet",
      "type": "terrestrial",
      "habitabilityIndex": 0.68,
      "physicalProperties": {
        "mass": 0.107,
        "radius": 0.532,
        "gravity": 0.378,
        "temperature": {
          "min": 130,
          "max": 308,
          "average": 210,
          "temperatureMetric1": 0.1,
          "temperatureMetric2": 0.1
        },
        "measurement1": 0.1,
        "measurement2": 0.1
      },
      "atmosphere": [
        {
          "compound": "CO2",
          "percentage": 95.3,
          "atmosphericData1": "string",
          "atmosphericData2": "string"
        }
      ],
      "discoveredAt": "1610-01-07T00:00:00.000Z",
      "image": "https://cdn.scalar.com/photos/mars.jpg",
      "satellites": [
        {
          "id": 1,
          "name": "Phobos",
          "description": "Phobos is the larger and innermost of the two moons of Mars.",
          "diameter": 22.2,
          "type": "moon",
          "orbit": {
            "orbitalPeriod": 0.319,
            "distance": 9376
          }
        }
      ],
      "creator": {
        "id": 1,
        "name": "Marc"
      },
      "tags": [
        "solar-system",
        "rocky",
        "explored"
      ],
      "lastUpdated": "2024-01-15T14:30:00.000Z",
      "successCallbackUrl": "https://example.com/webhook",
      "failureCallbackUrl": "https://example.com/webhook"
    }
  ],
  "meta": {
    "limit": 10,
    "offset": 0,
    "total": 100,
    "next": "/planets?limit=10&offset=10"
  }
}
```

## Example request

```bash
curl -X GET 'https://galaxy.scalar.com/planets'
```