---
title: "Lists the showcase, a page at a time"
method: GET
path: "/showcases/"
tags: ["Showcase"]
---

# Lists the showcase, a page at a time

`GET /showcases/`

## Request

- Base URL: `https://genhttp.dev/api/v1`
- URL: `https://genhttp.dev/api/v1/showcases/`
- Auth: none declared

Public. Only lambdas that are online are listed, the liveliest first: what was used over the last day, how recently
it was visited and changed, and a few days of being seen for a new entry. The order changes as they are used, so a
page read later may overlap the one before.

## Query parameters

- `skip` integer
- `take` integer

## Response `200`

A page of entries, and where the next one starts

- PageOfShowcaseResponse: A page of a listing that is read a page at a time, with `skip` and `take`.
  - `Entries` ShowcaseResponse[]: The entries of this page
    - `PublicKey` string: The public key of the lambda
    - `Title` string: What its owner calls it
    - `Description` string: What its owner says it is, and what a visitor can do with it
    - `Address` string: Where it answers - its own domain while it has one, its address below the hosting domain otherwise
    - `ImagePath` string: Where its picture is on this site; it changes with the picture, so it may be cached for good
    - `ImageType` string: The media type of the picture: `image/png`, `image/jpeg`, `image/gif` or `image/webp`
    - `ImageBytes` integer: How large the picture is, in bytes
    - `Online` boolean: Whether the lambda answers right now - the listing only has those
    - `Created` string, date-time: When it was put into the showcase
    - `Updated` string, date-time: When its entry last changed
  - `Total` integer: How many entries there are altogether
  - `Next` integer, nullable: The `skip` of the next page; absent when this was the last

## Other responses

- `204`: A response containing no body

---

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