Skip to main content
GET
/
cost-estimations
List cost estimations
curl --request GET \
  --url https://api.example.com/cost-estimations
Returns cost estimations for the organization, most recent first. Use offset-based pagination to page through results.
Scope required: read
Unlike most list endpoints, cost estimations use offset‑based pagination (limit + offset) instead of page + limit. See Pagination, filtering & sorting for the general conventions.

​
Request

curl "https://api.hacktron.ai/v1/cost-estimations?limit=20&offset=0" \
  -H "X-Api-Key: $HACKTRON_API_KEY"

​
Query parameters

ParameterTypeDefaultMaxDescription
limitinteger50100Number of items to return.
offsetinteger0—Number of items to skip.

​
Response

200 OK 
{
  "data": [
    {
      "id": "b4f5c6a1-2d3e-4f56-9a8b-0c1d2e3f4a5b",
      "organization_id": "f336d0bc-b841-465b-8045-024475c079dd",
      "user_id": "e5a6d7c8-9b0a-1c2d-3e4f-5a6b7c8d9e0f",
      "name": "nightly-estimate",
      "task_id": "cost_est_acme-backend_1712345678",
      "status": "completed",
      "repos": [
        {
          "source": "connected",
          "repo_url": "https://github.com/acme/backend",
          "branch": "main",
          "commit_sha": "abc123def456"
        }
      ],
      "total_credits": 4200,
      "repo_results": [
        {
          "repo_url": "https://github.com/acme/backend",
          "branch": "main",
          "commit_sha": "abc123def456",
          "status": "completed",
          "from_cache": false,
          "credits": 4200,
          "applications": [
            {
              "app_name": "backend-api",
              "app_root_path": "apps/api",
              "architecture": "NestJS REST API with PostgreSQL"
            }
          ]
        }
      ],
      "created_at": "2026-04-13T12:00:00.000Z",
      "updated_at": "2026-04-13T12:03:21.000Z"
    }
  ],
  "total": 42
}

​
Fields

FieldTypeDescription
dataobject[]The estimations on this page.
totalintegerTotal number of estimations in the organization.
See Create cost estimation for the full estimation object shape.