---
title: "Start an asynchronous job to bulk run calculators based on filtered configurations"
method: POST
path: "/app/v2/estimation_methods/run_async"
tags: ["estimation_methods"]
---

# Start an asynchronous job to bulk run calculators based on filtered configurations

`POST /app/v2/estimation_methods/run_async`

## Query parameters

- `preview` string
- `promote_to_record` string

## Request body

- CalculatorRunsFilter
  - `filters` object
    - `year_month` string
    - `status` 'not_configured' | 'missing_inputs' | 'ready_to_run' | 'run' | 'requires_re_run'
    - `estimation_method_id` string, uuid
    - `estimation_method.name` string
    - `estimation_method.analytics_calculator_id` string — ID of an analytics calculator, used to determine estimation method metadata
    - `estimation_method.analytics_library_id` string — ID of the library the analytics calculator ID belongs to
    - `estimation_method.entity_id` string — ID of the entity that the estimation belongs to
    - `estimation_method.entity_type` 'equipment' | 'flow' | 'asset_group'
    - `estimation_method.reporting_group_id` string
    - `entity_name` string
    - `entity_type` 'equipment' | 'flow' | 'asset_group'
    - `facility.id` string, uuid
    - `facility.name` string
    - `equipment.custom_attributes` object
    - `equipment.id` string
    - `equipment.name` string
    - `equipment.status` 'active' | 'inactive' | 'deprecated'
    - `equipment.type.id` string
    - `equipment.type.name` string
    - `flow.id` string
    - `flow.name` string
    - `flow.status` 'active' | 'inactive'
    - `flow.type` string — Use `id` value of any index in `GET /v1/flow_types`
    - `flow.product_type` string — Use `id` value of any index in `GET /v1/product_types`
    - `flow.product_category` string — Use `id` value of any index in `GET /v1/product_categories`
    - `flow.custom_attributes` CustomAttributes
    - `flow.associated_facility_id` string, uuid
    - `flow.associated_equipment_id` string, uuid
    - `equipment.facility.custom_attributes` object
    - `equipment.facility.id` string
    - `equipment.facility.name` string
    - `equipment.facility.status` string
    - `flow.facility.custom_attributes` object
    - `flow.facility.id` string
    - `flow.facility.name` string
    - `flow.facility.status` string
    - `flow.equipment.custom_attributes` object
    - `flow.equipment.id` string
    - `flow.equipment.name` string
    - `flow.equipment.status` 'active' | 'inactive' | 'deprecated'
    - `flow.equipment.type.id` string
    - `asset_group.id` string
    - `asset_group.name` string
    - `asset_group.status` 'active' | 'inactive'
    - `asset_group.asset_group_type_id` string
    - `asset_group.custom_attributes` object

## Response `200`

Successfully starts an asynchronous job to run estimation method calculations

- CalculatorAsyncRunsBulkResponse
  - `status` 'success' | 'failed'
  - `job` Job
    - `id` string, uuid
    - `company_id` string, uuid
    - `status` 'started' | 'finished' | 'failed' | 'partial'
    - `type` 'run_calculation' | 'apply_default_record_configuration' | 'apply_default_calculator_configuration'
    - `started_at` string, date-time
    - `finished_at` string, date-time
    - `duration` number
    - `input` object
    - `output` object
    - `total_items` number
    - `processed_items` number
    - `item_status_counts` JobItemStatusCounts
      - `success` number
      - `failed` number
      - `skipped` number

---

[API](https://skmtc.net/validere/apis/carbonhub-api.md) · [All operations](https://skmtc.net/validere/apis/carbonhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/validere/carbonhub-api/revisions/053edab62415/schema)