---
title: "List bookable resources"
method: GET
path: "/api/resources/list"
tags: ["resources"]
---

# List bookable resources

`GET /api/resources/list`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/resources/list`
- Auth: HTTP bearer

Clerk session or agt_ token with `resources:read`. Returns the resource catalog plus a staleness gauge.

## Response `200`

Bookable resources.

- ResourcesListResponse
  - `ok` boolean, required
  - `resources` object[]
  - `via` 'clerk' | 'agent'

## Other responses

- `401`: No auth.
- `403`: Scope not authorized.
- `500`: Read failed.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)