# MSHA Mine Data Retrieval Scraper - US Mines Production + Safety (`jungle_synthesizer/msha-mine-data-retrieval-scraper`) Actor

Extract US mine records from MSHA Open Government Data CSVs. Covers coal, metal, and nonmetal mines: mine ID, operator, controller, state/county, geocoordinates, mine type, commodity, status, employees, quarterly production tons, violations, and accidents.

- **URL**: https://apify.com/jungle\_synthesizer/msha-mine-data-retrieval-scraper.md
- **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community)
- **Categories:** Business, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## MSHA Mine Data Retrieval Scraper

Extracts US mine records from the [MSHA Open Government Data portal](https://arlweb.msha.gov/OpenGovernmentData/OGIMSHA.asp). Returns mine identity, operator and controller info, geocoordinates, commodity classification, status, employee counts, and — optionally — quarterly production tons, ownership history, violations, and accident counts for all 91,000+ mines in the MSHA registry.

### MSHA Mine Scraper Features

- **Extracts 26+ fields per mine record** — mine ID, name, operator, controller (ultimate parent), state, county, FIPS code, lat/lon, mine type, mine class, commodity, SIC code, status, employees, operating days, nearest town, MSHA district and office
- **Filters by mine class** — coal, metal/nonmetal, or all
- **Filters by commodity** — substring match against SIC description (lithium, copper, iron, bituminous, anthracite, stone, sand, gravel, and any other MSHA commodity label)
- **Filters by status** — Active, Temporarily Idled, NonProducing, Abandoned, New Mine, Intermittent, or all
- **Joins quarterly production history** — all historical production tons, hours worked, and average employee counts by quarter and subunit, back to the first recorded year
- **Joins operator/controller history** — the full M&A ownership chain with start/end dates for each controller and operator
- **Joins violations** — citation count for the past 12 months plus a structured history of recent violations with section-of-act and violation type
- **Joins accident records** — injury and accident count for the past 12 months
- **No proxy required** — MSHA open data is public and does not block bulk downloads

### What Can You Do With MSHA Mine Data?

- **Utility and coal analysts** — pull quarterly production tons by mine, subunit, and commodity to track output trends without manual MSHA portal navigation
- **Critical-minerals researchers** — filter active metal/nonmetal mines by commodity (lithium, copper, cobalt, rare earths) and get operator, location, and production context in one run
- **Mining M&A advisory** — join the controller history dataset to reconstruct the full ownership chain for a target mine or portfolio
- **Environmental NGOs** — identify active surface mines by state and county, then enrich with violation counts to prioritize investigation targets
- **Compliance teams** — pull violation and accident histories to benchmark a mine's safety record against peers in the same district
- **Data journalists** — map every active mine in a given state with geocoordinates and production figures, without downloading and parsing multiple MSHA ZIP files by hand

### How It Works

1. **Downloads the MSHA Mines registry** — the master registry ZIP (7.3 MB compressed, ~91,000 rows) is pulled from the MSHA open data endpoint and parsed in memory
2. **Applies your filters** — coal/metal class, status, and commodity filters run against the registry before any joins, so enrichment datasets only load for mines that match
3. **Joins optional datasets in parallel** — if you request quarterly production, controller history, violations, or accidents, those ZIPs are downloaded concurrently and indexed by MINE_ID
4. **Returns structured records** — each mine record is written to the dataset with flat fields for registry data and JSON strings for the array joins (production, history, violations)

The production quarterly dataset is 56 MB compressed and covers 35,000 unique mines. Controller history runs ~119 MB. Factor that into your run time when enabling those options.

### MSHA Mine Scraper Input

```json
{
  "coalOrMetal": "M",
  "commodityFilter": "copper",
  "mineStatus": "Active",
  "includeProductionHistory": true,
  "includeControllerHistory": false,
  "includeViolations": false,
  "includeAccidents": false,
  "maxItems": 100,
  "sp_intended_usage": "critical minerals research",
  "sp_improvement_suggestions": "none"
}
````

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `coalOrMetal` | string | `"all"` | Mine class filter: `"all"`, `"C"` (coal only), or `"M"` (metal/nonmetal only) |
| `commodityFilter` | string | `""` | Substring match against SIC description (case-insensitive). Leave blank for all commodities. |
| `mineStatus` | string | `"Active"` | Status filter: Active, Temporarily Idled, NonProducing, Abandoned, Abandoned and Sealed, New Mine, Intermittent, or all |
| `includeProductionHistory` | boolean | `true` | Join quarterly production CSV to add `production_quarterly` |
| `includeControllerHistory` | boolean | `false` | Join controller/operator history CSV to add `operator_history` |
| `includeViolations` | boolean | `false` | Join violations CSV to add `violations_count_12mo` and `violations_history` |
| `includeAccidents` | boolean | `false` | Join accidents CSV to add `accidents_12mo` |
| `maxItems` | integer | `10` | Maximum records to return. Set to 0 for unlimited. |
| `sp_intended_usage` | string | — | Required. Describe your intended use of this data. |
| `sp_improvement_suggestions` | string | — | Required. Share any suggestions for improving the actor. |

### MSHA Mine Scraper Output Fields

```json
{
  "mine_id": "4200017",
  "mine_name": "EMERALD MINE NO 1",
  "coal_metal_ind": "C",
  "mine_type": "Underground",
  "mine_status": "Active",
  "status_date": "1978-12-15",
  "controller_id": "0000055",
  "controller_name": "CONSOL ENERGY INC",
  "controller_start_date": "2020-01-01",
  "operator_id": "0218869",
  "operator_name": "CONSOL PENNSYLVANIA COAL COMPANY LLC",
  "state": "PA",
  "county": "GREENE",
  "fips_county_code": "059",
  "latitude": 39.8219,
  "longitude": -80.1781,
  "primary_sic_code": "1220",
  "primary_commodity": "Bituminous Coal",
  "primary_canvass": "Coal(Bituminous)",
  "secondary_commodity": "",
  "num_employees": 350,
  "days_per_week": 5,
  "nearest_town": "Wind Ridge",
  "district": "3",
  "office_name": "Waynesburg District",
  "portable_operation": "N",
  "production_quarterly": "[{\"cal_yr\":2024,\"cal_qtr\":3,\"subunit\":\"UNDERGROUND\",\"avg_employees\":341,\"hours_worked\":148560,\"coal_production\":1247000},{\"cal_yr\":2024,\"cal_qtr\":2,...}]",
  "operator_history": null,
  "violations_count_12mo": null,
  "violations_history": null,
  "accidents_12mo": null,
  "source_url": "https://arlweb.msha.gov/OpenGovernmentData/OGIMSHA.asp"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `mine_id` | string | MSHA Mine ID (7-digit, primary key) |
| `mine_name` | string | Current mine name from Legal ID Form |
| `coal_metal_ind` | string | Mine class: C=Coal, M=Metal/NonMetal |
| `mine_type` | string | Mine type: Surface, Underground, Facility, or Other |
| `mine_status` | string | Current status: Active, Temporarily Idled, NonProducing, Abandoned, etc. |
| `status_date` | string | Date mine entered current status (YYYY-MM-DD) |
| `controller_id` | string | MSHA controller ID for the ultimate parent entity |
| `controller_name` | string | Name of the controller (ultimate parent of operator) |
| `controller_start_date` | string | Date current controller took control (YYYY-MM-DD) |
| `operator_id` | string | MSHA operator ID |
| `operator_name` | string | Current operator name |
| `state` | string | 2-letter state abbreviation |
| `county` | string | County name (FIPS county name) |
| `fips_county_code` | string | 3-digit FIPS county code |
| `latitude` | number | Mine latitude (decimal degrees) |
| `longitude` | number | Mine longitude (decimal degrees) |
| `primary_sic_code` | string | Primary SIC code |
| `primary_commodity` | string | Primary commodity description (SIC description) |
| `primary_canvass` | string | Primary industry group (e.g., Coal(Bituminous), M/NM (Stone), Metal) |
| `secondary_commodity` | string | Secondary commodity description |
| `num_employees` | number | Number of workers at mine |
| `days_per_week` | number | Operating days per week |
| `nearest_town` | string | Nearest town or city |
| `district` | string | MSHA district code |
| `office_name` | string | MSHA office responsible for inspections |
| `portable_operation` | string | Y/N portable mine indicator |
| `production_quarterly` | string | JSON array of quarterly production records — `cal_yr`, `cal_qtr`, `subunit`, `avg_employees`, `hours_worked`, `coal_production` (requires `includeProductionHistory: true`) |
| `operator_history` | string | JSON array of controller/operator history records — `controller_name`, `operator_name`, `operator_start_dt`, `operator_end_dt`, `controller_start_dt`, `controller_end_dt`, `mine_status` (requires `includeControllerHistory: true`) |
| `violations_count_12mo` | number | Violations issued in the past 12 months (requires `includeViolations: true`) |
| `violations_history` | string | JSON array of recent violations — `violation_no`, `inspection_begin_dt`, `violation_issue_dt`, `cal_yr`, `violator_name`, `section_of_act`, `violation_type` (requires `includeViolations: true`) |
| `accidents_12mo` | number | Accident/injury records in the past 12 months (requires `includeAccidents: true`) |
| `source_url` | string | URL of the source MSHA open data page |

### 🔍 FAQ

#### How do I extract MSHA mine data?

MSHA Mine Data Retrieval Scraper pulls directly from the MSHA Open Government Data bulk CSV exports. Configure your filters in the input, run the actor, and download the dataset — no MSHA portal account or manual CSV downloads required.

#### What does MSHA Mine Data Retrieval Scraper cost to run?

The actor charges $0.10 per run plus $0.001 per record. Pulling 1,000 active coal mines with quarterly production history runs roughly $1.10 total. Enabling the controller history dataset (119 MB download) adds compute time but not additional per-record cost.

#### Can I filter by specific commodities like lithium or copper?

Yes. Set `commodityFilter` to any commodity keyword and the actor does a case-insensitive substring match against the MSHA SIC description. `"copper"` returns copper mines, `"lithium"` returns lithium mines, `"stone"` returns crushed stone operations. Leave it blank to get all commodities.

#### Does MSHA Mine Data Retrieval Scraper need proxies?

No. MSHA open data is publicly available without authentication or rate limits. The actor downloads ZIP files directly from the MSHA server — no proxy configuration needed.

#### How current is the mine data?

MSHA updates the open data CSVs regularly. The actor always pulls the latest published version at run time. The `status_date` field tells you when each mine's current status was last changed by MSHA.

***

### Need More Features?

Need custom filters, additional MSHA datasets, or scheduled runs? [File an issue](https://console.apify.com/actors/issues) or get in touch.

### Why Use MSHA Mine Data Retrieval Scraper?

- **Covers the full registry** — all 91,000+ mines across coal, metal, and nonmetal classes, with optional joins for production history, ownership chain, violations, and accidents in a single run
- **No proxies, no auth, no scraping fragility** — pulls from official government bulk exports, so it doesn't break when MSHA updates their web UI
- **Clean structured output** — flat JSON records with consistent field names, ready for a spreadsheet, database, or downstream pipeline without reformatting

# Actor input Schema

## `sp_intended_usage` (type: `string`):

Please describe how you plan to use the data extracted by this crawler.

## `sp_improvement_suggestions` (type: `string`):

Provide any feedback or suggestions for improvements.

## `sp_contact` (type: `string`):

Provide your email address so we can get in touch with you.

## `coalOrMetal` (type: `string`):

Filter by mine class: Coal (C) or Metal/NonMetal (M). Default: all.

## `commodityFilter` (type: `string`):

Filter by primary commodity keyword (case-insensitive substring match against SIC description). Examples: lithium, copper, iron, bituminous, anthracite, stone, sand. Leave blank for all commodities.

## `mineStatus` (type: `string`):

Filter by current mine status. Default: Active mines only.

## `includeProductionHistory` (type: `boolean`):

Join the quarterly employment/production CSV to add production\_quarterly array. Adds ~30s download time and ~600 MB peak memory — enable only with 2048+ MB allocated.

## `includeControllerHistory` (type: `boolean`):

Join the controller/operator history CSV to add operator\_history array (M\&A chain). Adds ~60s download time for the 119MB dataset.

## `includeViolations` (type: `boolean`):

Join the violations CSV to add violations\_count\_12mo and violations\_history array. Adds download time.

## `includeAccidents` (type: `boolean`):

Join the accidents CSV to add accidents\_12mo count.

## `maxItems` (type: `integer`):

Maximum number of mine records to return. Use 0 for unlimited.

## Actor input object example

```json
{
  "sp_intended_usage": "Describe your intended use...",
  "sp_improvement_suggestions": "Share your suggestions here...",
  "sp_contact": "Share your email here...",
  "coalOrMetal": "all",
  "mineStatus": "Active",
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "sp_intended_usage": "Describe your intended use...",
    "sp_improvement_suggestions": "Share your suggestions here...",
    "sp_contact": "Share your email here...",
    "coalOrMetal": "all",
    "commodityFilter": "",
    "mineStatus": "Active",
    "includeProductionHistory": false,
    "includeControllerHistory": false,
    "includeViolations": false,
    "includeAccidents": false,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("jungle_synthesizer/msha-mine-data-retrieval-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "sp_intended_usage": "Describe your intended use...",
    "sp_improvement_suggestions": "Share your suggestions here...",
    "sp_contact": "Share your email here...",
    "coalOrMetal": "all",
    "commodityFilter": "",
    "mineStatus": "Active",
    "includeProductionHistory": False,
    "includeControllerHistory": False,
    "includeViolations": False,
    "includeAccidents": False,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("jungle_synthesizer/msha-mine-data-retrieval-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "sp_intended_usage": "Describe your intended use...",
  "sp_improvement_suggestions": "Share your suggestions here...",
  "sp_contact": "Share your email here...",
  "coalOrMetal": "all",
  "commodityFilter": "",
  "mineStatus": "Active",
  "includeProductionHistory": false,
  "includeControllerHistory": false,
  "includeViolations": false,
  "includeAccidents": false,
  "maxItems": 10
}' |
apify call jungle_synthesizer/msha-mine-data-retrieval-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jungle_synthesizer/msha-mine-data-retrieval-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "MSHA Mine Data Retrieval Scraper - US Mines Production + Safety",
        "description": "Extract US mine records from MSHA Open Government Data CSVs. Covers coal, metal, and nonmetal mines: mine ID, operator, controller, state/county, geocoordinates, mine type, commodity, status, employees, quarterly production tons, violations, and accidents.",
        "version": "0.1",
        "x-build-id": "sm2y2WTgHWMz1xuda"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/jungle_synthesizer~msha-mine-data-retrieval-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-jungle_synthesizer-msha-mine-data-retrieval-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/jungle_synthesizer~msha-mine-data-retrieval-scraper/runs": {
            "post": {
                "operationId": "runs-sync-jungle_synthesizer-msha-mine-data-retrieval-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/jungle_synthesizer~msha-mine-data-retrieval-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-jungle_synthesizer-msha-mine-data-retrieval-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "sp_intended_usage",
                    "sp_improvement_suggestions"
                ],
                "properties": {
                    "sp_intended_usage": {
                        "title": "What is the intended usage of this data?",
                        "minLength": 1,
                        "type": "string",
                        "description": "Please describe how you plan to use the data extracted by this crawler."
                    },
                    "sp_improvement_suggestions": {
                        "title": "How can we improve this crawler for you?",
                        "minLength": 1,
                        "type": "string",
                        "description": "Provide any feedback or suggestions for improvements."
                    },
                    "sp_contact": {
                        "title": "Contact Email",
                        "minLength": 1,
                        "type": "string",
                        "description": "Provide your email address so we can get in touch with you."
                    },
                    "coalOrMetal": {
                        "title": "Mine Class Filter",
                        "enum": [
                            "all",
                            "C",
                            "M"
                        ],
                        "type": "string",
                        "description": "Filter by mine class: Coal (C) or Metal/NonMetal (M). Default: all."
                    },
                    "commodityFilter": {
                        "title": "Commodity Filter",
                        "type": "string",
                        "description": "Filter by primary commodity keyword (case-insensitive substring match against SIC description). Examples: lithium, copper, iron, bituminous, anthracite, stone, sand. Leave blank for all commodities."
                    },
                    "mineStatus": {
                        "title": "Mine Status Filter",
                        "enum": [
                            "all",
                            "Active",
                            "Temporarily Idled",
                            "NonProducing",
                            "Abandoned",
                            "Abandoned and Sealed",
                            "New Mine",
                            "Intermittent"
                        ],
                        "type": "string",
                        "description": "Filter by current mine status. Default: Active mines only."
                    },
                    "includeProductionHistory": {
                        "title": "Include Quarterly Production History",
                        "type": "boolean",
                        "description": "Join the quarterly employment/production CSV to add production_quarterly array. Adds ~30s download time and ~600 MB peak memory — enable only with 2048+ MB allocated."
                    },
                    "includeControllerHistory": {
                        "title": "Include Controller/Operator History",
                        "type": "boolean",
                        "description": "Join the controller/operator history CSV to add operator_history array (M&A chain). Adds ~60s download time for the 119MB dataset."
                    },
                    "includeViolations": {
                        "title": "Include Violation History",
                        "type": "boolean",
                        "description": "Join the violations CSV to add violations_count_12mo and violations_history array. Adds download time."
                    },
                    "includeAccidents": {
                        "title": "Include Accident History",
                        "type": "boolean",
                        "description": "Join the accidents CSV to add accidents_12mo count."
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "type": "integer",
                        "description": "Maximum number of mine records to return. Use 0 for unlimited.",
                        "default": 10
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
