---
title: "Lists every lambda"
method: GET
path: "/admin/lambdas"
tags: ["Administration"]
---

# Lists every lambda

`GET /admin/lambdas`

## Request

- Base URL: `https://genhttp.dev/api/v1`
- URL: `https://genhttp.dev/api/v1/admin/lambdas`
- Auth: none declared. Required headers: `X-Admin-Token`

Newest first, twenty to a page, with what each has been doing since the server came up, which is counted in memory.

## Query parameters

- `search` string
- `tier` string
- `page` integer

## Headers

- `X-Admin-Token` string, required

## Response `200`

A page of lambdas

- AdminListingResponse: A page of every lambda on the installation.
  - `Lambdas` AdminLambda[]: The lambdas of this page
    - `PublicKey` string: Its public key
    - `PrivateKey` string: Its editor key
    - `Tier` string: `Free`, `Premium` or `Demo`
    - `Created` string, date-time: When it was created
    - `Modified` string, date-time: When something about it last changed
    - `ActiveVersion` integer, nullable: The version online; absent while none is
    - `LatestVersion` integer, nullable: Its newest version
    - `Versions` integer: How many versions are kept
    - `DeployedUntil` string, date-time, nullable: When it is taken offline unless it is used before then
    - `KeptUntil` string, date-time, nullable: When it is deleted unless it is used before then
    - `Requests` integer: Requests since the server came up
    - `Failed` integer: Of those, answered with a server error
    - `LastSeen` string, date-time, nullable: When the last request arrived, since the server came up
    - `Domain` string, nullable: The domain of its own, if it has one
    - `DomainServed` boolean: Whether it answers at that domain
  - `Total` integer: How many lambdas there are
  - `Deployed` integer: How many of them are online
  - `Matched` integer: How many the search matched, which is what the pages count from
  - `Page` integer: The page this is, counting from 1
  - `Pages` integer: How many pages there are

## Other responses

- `204`: A response containing no body
- `400`: There is no such tier.
- `401`: The token is missing.
- `403`: The token is wrong.

---

[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)