---
title: "List cost estimations"
method: GET
path: "/cost-estimations"
tags: ["REST API - Cost Estimations"]
---

# List cost estimations

`GET /cost-estimations`

## Query parameters

- `limit` number
- `offset` number

## Response `200`

- RestCostEstimationListResponseDto
  - `data` CostEstimationResponseDto[], required
    - `id` string, required — Estimation UUID
    - `organization_id` string, required — Organization UUID
    - `user_id` string, required — User UUID
    - `name` string — Friendly name for this estimation
    - `task_id` string, required — Task identifier
    - `status` 'pending' | 'running' | 'completed' | 'partial' | 'failed', required — Estimation status
    - `repos` RepoInputResponseDto[], required — Input repositories
      - `source` 'connected' | 'public' | 'upload' — Source type
      - `repo_url` string — Repository URL
      - `branch` string — Branch name
      - `commit_sha` string — Resolved commit SHA
      - `archive_id` string — Archive ID (for upload sources)
    - `total_credits` number — Total estimated credits across all repos
    - `repo_results` RepoResultResponseDto[] — Per-repo estimation results
      - `repo_url` string, required — Repository URL
      - `branch` string — Branch name
      - `commit_sha` string — Commit SHA
      - `status` 'completed' | 'failed', required — Result status
      - `from_cache` boolean, required — Whether result was served from cache
      - `applications` RepoResultApplicationDto[] — Detected applications
        - `app_name` string, required — Application name
        - `app_root_path` string, required — Application root path
        - `architecture` string — Architecture description
      - `credits` number — Estimated credits for this repo
      - `error` string — Error message (when status is failed)
      - `failure_reason` 'unsupported_language' — Structured failure reason
      - `unsupported_languages` string[] — Detected unsupported languages among the top languages
    - `error` string — Error message
    - `triage_required` boolean, required — Whether human triage is mandatory for a scan of this estimation (large app, above the predicted-cost threshold). The customer cannot opt out when true.
    - `triage_fee_credits` number, required — Triage fee in credits (a percentage of the scan base credits) added when triage is enabled
    - `created_at` string, date-time, required — Timestamp when estimation was created
    - `updated_at` string, date-time, required — Timestamp when estimation was last updated
  - `total` number, required

---

[API](https://skmtc.dev/hacktron/apis/hacktron-rest-api.md) · [All operations](https://skmtc.dev/hacktron/apis/hacktron-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hacktron/hacktron-rest-api/revisions/6a361244ce2c/schema)