---
title: "Get Compare Lists"
method: GET
path: "/v1/users/me/compare-lists"
tags: ["v1", "users"]
---

# Get Compare Lists

`GET /v1/users/me/compare-lists`

## Request

- Base URL: `https://thrustlab.com`
- URL: `https://thrustlab.com/v1/users/me/compare-lists`
- Auth: HTTP bearer

Return the account's comparison shortlists, one per component type.

Each entry is `{id, added_at}` — the public component id and the ISO-8601
instant it was added — ordered newest first and capped at ten per type. All
three types are always present; an account that has never compared anything
reads three empty lists rather than a 404.

The list a signed-out visitor builds lives on their device. This is where it
goes once there is an account, so it follows them to another browser.

## Response `200`

Successful Response

- CompareListsResource
  - `lists` CompareListsOut, required: Every type, always all three, newest first and at most ten each.
    - `battery` CompareEntry[], required
      - `added_at` string, required: ISO-8601 UTC instant the component was added to the list.
      - `id` string, required: Public component id (`comp_…`).
    - `motor` CompareEntry[], required
      - `added_at` string, required: ISO-8601 UTC instant the component was added to the list.
      - `id` string, required: Public component id (`comp_…`).
    - `propeller` CompareEntry[], required
      - `added_at` string, required: ISO-8601 UTC instant the component was added to the list.
      - `id` string, required: Public component id (`comp_…`).
  - `object` string

---

[API](https://skmtc.dev/thrustlab/apis/thrustlab-api.md) · [All operations](https://skmtc.dev/thrustlab/apis/thrustlab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrustlab/apis/thrustlab-api/revisions/c19717e52529?raw)
