---
title: "One ranking"
method: GET
path: "/lists/{slug}.json"
tags: ["Catalog"]
---

# One ranking

`GET /lists/{slug}.json`

## Request

- Base URL: `https://listme.name/api/v1`
- URL: `https://listme.name/api/v1/lists/{slug}.json`
- Auth: none required

A ranked list: criteria, how to choose, FAQ and every entry with score, verdict and full product facts.

## Path parameters

- `slug` string, required

## Query parameters

- `filter` string

## Response `200`

One ranking

- Ranking
  - `slug` string, required
  - `name` string, required
  - `title` string
  - `category` string
  - `filter` string, nullable
  - `available_filters` string[]
  - `page` string, uri
  - `json` string, uri
  - `updated` string, date
  - `intro` string
  - `criteria` string[]
  - `specs` object[]
  - `how_to_choose` object[]
  - `faq` object[]
  - `entries` Entry[], required
    - `rank` integer, required
    - `score` number, required
    - `verdict` string
    - `best_for` string
    - `spec` object
    - `product` Product, required
      - `slug` string, required
      - `name` string, required
      - `kind` string, required
      - `website` string, uri, required
      - `page` string, uri, required
      - `tagline` string
      - `summary` string
      - `developer` string
      - `author` string
      - `platforms` string[]
      - `formats` string[]
      - `pricing` string
      - `price_note` string
      - `free_to_use` boolean
      - `open_source` boolean
      - `license` string
      - `source` string, uri
      - `strengths` string[]
      - `limits` string[]
      - `checked` string, date: Date the facts were last checked against the vendor.
      - `connected_to_publisher` boolean
      - `cover` string, uri
  - `notes` string[]

## Other responses

- `400`: The request was invalid or the item does not exist.
- `404`: The request was invalid or the item does not exist.

---

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