---
title: "List your feasibility analyses"
method: GET
path: "/api/v1/feasibility/analyses"
tags: ["feasibility"]
---

# List your feasibility analyses

`GET /api/v1/feasibility/analyses`

## Request

- Base URL: `https://buckybuild.com`
- URL: `https://buckybuild.com/api/v1/feasibility/analyses`
- Auth: HTTP bearer

Cursor-paginated list of analyses created by the authenticated caller, newest first. **Requires authentication** — anonymous callers receive `AUTH_REQUIRED`, unlike the other analyses endpoints which serve anonymous callers a redacted payload. Query params: `limit` (1–100, default 20) and `cursor`. Summaries deliberately omit the heavy `deterministic` and `site` payloads; fetch a full analysis by id. Uses the `PUBLIC_READ_HEAVY` bucket.

## Response `200`

Cursor-paginated list of analysis summaries.

- FeasibilityAnalysisList
  - `items` FeasibilityAnalysisSummary[], required
    - `analysisId` string, uuid, required
    - `status` string, required
    - `siteId` string, uuid, nullable, required
    - `createdAt` string, date-time, required
    - `generatedAt` string, date-time, nullable, required
  - `nextCursor` string, nullable, required: Opaque keyset cursor. Pass back as `?cursor=` for the next page; `null` when exhausted.

## Other responses

- `400`: Validation or client error.
- `401`: Authentication required.
- `403`: Insufficient permissions.
- `404`: No such resource, or no such route under this version prefix.
- `429`: Rate limit exceeded (`code: RATE_LIMIT_EXCEEDED`, `retryable: true`). Honour `Retry-After`.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/buckybuild/apis/bucky-public-api.md) · [All operations](https://skmtc.dev/buckybuild/apis/bucky-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buckybuild/apis/bucky-public-api/revisions/30e442927a24?raw)
