---
title: "Every publicly listed hosted endpoint"
method: GET
path: "/api/v1/listings"
tags: ["Listings"]
---

# Every publicly listed hosted endpoint

`GET /api/v1/listings`

## Request

- Base URL: `https://console.archstone.dev`
- URL: `https://console.archstone.dev/api/v1/listings`
- Auth: none required

## Response `200`

Every visible listing (approved, or approved and under escalation re-review), minimal fields only.

- PublicListing[]
  - `slug` string, required
  - `displayName` string, required
  - `description` string, required
  - `website` string, nullable, required
  - `logoRef` string, nullable, required: A `data:` URI (base64), or null when the listing carries no logo.
  - `accessMode` 'public' | 'oauth', required
  - `capabilities` PublicListingCapability[], required
    - `name` string, required
    - `effect` string, required

## Other responses

- `404`: This deployment does not carry multi-tenant hosting (self-hosted).
- `429`: This remote address has read too many times in the current window.

---

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