---
title: "GET /orgs/{org_id}/previews"
method: GET
path: "/orgs/{org_id}/previews"
tags: ["preview"]
---

# GET /orgs/{org_id}/previews

`GET /orgs/{org_id}/previews`

List project previews for the organization

## Path parameters

- `org_id` string, required

## Query parameters

- `preview_status` 'starting' | 'running'

## Response `200`

Previews listed

- ListPreviewsResponse — Previews currently visible for the organization.
  - `previews` PreviewInfo[], required
    - `components` PreviewComponent[], required
      - `component` string, required — Which part of the preview this row describes: `api` (backend dev server) or `ui` (frontend dev server).
      - `healthy` boolean, nullable — Whether the dev server answered a health check on its port. Absent when no check was performed.
    - `project_id` integer, nullable — Included on organization-wide preview listings so you can tell which project a row belongs to.
    - `rev` string, required — Git branch name this preview is tied to.
    - `slug` string, required — Opaque token used with your organization’s preview hostname.
    - `started_at` string, date-time, required — UTC timestamp when acceptance of the preview start was recorded.
    - `status` 'starting' | 'running'
    - `url` string, nullable — Public HTTPS URL for the running preview, when preview hosting is configured for your organization.

## Other responses

- `403` — Caller is not a member of the org

## Changes

- **2026-04-14** `d53a5f0127ee` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/previews/get.md)

---

[API](https://skmtc.dev/timbal-ai/apis/timbal-platform-api.md) · [All operations](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/revisions/ad37ee8d504e?raw)