# Public Holidays Worldwide Scraper (`parseforge/public-holidays-scraper`) Actor

Pull public holidays for 100+ countries by year. Returns date, local name, English name, country code, type (public/bank/optional), counties affected, and launch year. Multi-country runs and year ranges. Useful for HR, payroll, calendaring, and travel apps.

- **URL**: https://apify.com/parseforge/public-holidays-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Travel, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🎉 Public Holidays Worldwide Scraper

> 🚀 **Pull public holidays for 100+ countries by year: date, local + English name, type, counties affected, and launch year.**

> 🕒 **Last updated:** 2026-05-07 · **📊 11 fields** per record · **100+ countries** · public, bank, optional, school holidays · multi-country runs and year ranges

The **Public Holidays Worldwide Scraper** pulls public-holiday calendars for 100+ countries, year by year. Output includes the date, local-language name, English name, country code, holiday type (public/bank/optional/school), counties affected for sub-national holidays, and the launch year for newer observances.

The dataset covers **every country supported by the Nager.Date global holiday API**, which spans 100+ nations including all G20 economies, all EU member states, and most Latin American, Asian, African, and Oceanic countries. Multi-country runs and multi-year date ranges are supported.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| HR, payroll, calendar apps, travel platforms, schedulers, internal company tools, journalists | HR leave-balance calculation, payroll cutoffs, corporate calendar overlays, travel-app country pages, retail planning |

---

### 📋 What the Public Holidays Worldwide Scraper does

Five filtering workflows in a single run:

- 🌍 **Multi-country runs.** Pass any ISO-2 country code or leave empty for every supported country.
- 📅 **Year ranges.** Single year or YYYY:YYYY range for multi-year exports.
- 🏷️ **Type metadata.** Public, bank, optional, school, observance flags.
- 🗺️ **County-level holidays.** Sub-national holiday flags for federal countries.
- 📅 **Launch year.** When a holiday was first established (when known).

> 💡 **Why it matters:** clean, server-side filtering and fresh data on every run.

---
### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan up to 1,000,000.</td></tr>
<tr><td><code>country</code></td><td>string</td><td><code>"US"</code></td><td>ISO-2 code. Empty = every supported country.</td></tr>
<tr><td><code>yearStart</code></td><td>integer</td><td><code>2026</code></td><td>Earliest year to fetch.</td></tr>
<tr><td><code>yearEnd</code></td><td>integer</td><td><code>0</code></td><td>Latest year. Empty = same as yearStart.</td></tr>
</tbody>
</table>

**Example: every US holiday in 2026.**

```json
{
    "maxItems": 50,
    "country": "US",
    "yearStart": 2026
}
````

**Example: every holiday in every country in 2026.**

```json
{
    "maxItems": 2000,
    "yearStart": 2026
}
```

***

### 📊 Output

Each record contains **11 fields**. Download as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 📅 `date` | string | `"2026-12-25"` |
| 📛 `localName` | string | `"Christmas Day"` |
| 📛 `name` | string | `"Christmas Day"` |
| 🆔 `countryCode` | string | `"US"` |
| 📅 `year` | number | `2026` |
| 🟢 `global` | boolean | `true` |
| 📌 `fixed` | boolean | `true` |
| 🏷️ `types` | array | `["Public"]` |
| 🗺️ `counties` | array | null | `["DE-BB","DE-BE"]` |
| 📅 `launchYear` | number | null | `null` |

#### 📦 Sample records

<details>
<summary><strong>🎄 Christmas in US</strong></summary>

```json
{"date":"2026-12-25","localName":"Christmas Day","name":"Christmas Day","countryCode":"US","year":2026,"global":true,"types":["Public"]}
```

</details>

<details>
<summary><strong>🎌 Boxing Day UK</strong></summary>

```json
{"date":"2026-12-26","localName":"Boxing Day","name":"St. Stephen's Day","countryCode":"GB","year":2026,"global":true,"types":["Public"]}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🌍 | **100+ countries.** All G20 + EU + most LATAM/Asia/Africa. |
| 📅 | **Year ranges.** Multi-year exports in a single run. |
| 🏷️ | **Type-tagged.** Public, bank, optional, school, observance flags. |
| 🗺️ | **County-level.** Sub-national holidays for federal nations. |
| ⚡ | **Fast.** Hundreds of holidays in seconds. |

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ This Actor** | $5 free credit | **100+** countries | Live per run | country, year range | ⚡ 2 min |
| Manual gov website scraping | Free | Per-country | Variable | DIY | 🐢 Days |
| Calendarific | $$/month | Similar | Live | Yes | 🐢 Account |
| Hard-coded calendars | Free | Stale | Manual | None | 🐢 Maintenance |

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Find the Public Holidays Worldwide Scraper on the Apify Store.
3. 🎯 **Set input.** Pick filters and `maxItems`.
4. 🚀 **Run it.** Click **Start**.
5. 📥 **Download.** Grab results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 👥 HR + Payroll

- Leave-balance calculations
- Payroll cutoff scheduling
- Compliance with sub-national holidays
- Multi-country team calendars

</td>
<td width="50%" valign="top">

#### 📅 Calendars + Schedulers

- Calendar overlay backgrounds
- Meeting-scheduler avoidance
- Travel-day blocking
- Out-of-office defaults

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🛒 Retail + Operations

- Holiday-week stock planning
- Logistics cutoffs
- Marketing campaign timing
- Customer-service staffing

</td>
<td width="50%" valign="top">

#### ✈️ Travel Apps

- Country travel-day previews
- Best-time-to-visit indicators
- Local festival listings
- Banking-day notices

</td>
</tr>
</table>

***

### 🔌 Automating Public Holidays Worldwide Scraper

Control the scraper programmatically:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Cross-cultural calendar studies
- Reproducible holiday snapshots
- Course materials with current data
- Comparative public-policy research

</td>
<td width="50%">

#### 🎨 Personal and creative

- Personal calendar overlays
- Travel planning side projects
- Holiday-themed newsletters
- Hobbyist year-overview tools

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- NGO event-planning
- Civic calendar projects
- Cultural-heritage cataloging
- Educational outreach

</td>
<td width="50%">

#### 🧪 Experimentation

- Train scheduler models
- Prototype calendar-aware agents
- Test travel-app features
- Build event-recommendation engines

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Public%20Holidays%20Worldwide%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Public%20Holidays%20Worldwide%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Public%20Holidays%20Worldwide%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Public%20Holidays%20Worldwide%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Provide a country code (or leave empty) and year (or year range). The Actor calls the Nager.Date public-holiday API and emits one record per holiday.

#### 🌍 Which countries are covered?

100+, including all G20 economies, all 27 EU member states, and most Latin American, Asian, African, and Oceanic countries. Empty country = every supported country.

#### 📊 How many fields per record?

11, including date, local name, English name, country code, year, type tags, fixed flag, global flag, counties, and launch year.

#### 🏷️ What do the type tags mean?

Public = federal observance, Bank = bank closure, Optional = some employers, School = school closure, Observance = cultural but not work-affecting.

#### 🗺️ What are counties?

Sub-national codes (e.g. ISO 3166-2). When `global` is false, the holiday only applies in the listed counties or states.

#### 🔁 Can I schedule runs?

Yes. Schedule annually to capture next year's holidays as they're published.

#### ⚖️ Is this data free to use?

Yes. The underlying Nager.Date dataset is open source and free for commercial use.

#### 💳 Do I need a paid Apify plan?

No. The free plan covers preview runs.

#### 🆘 What if a run fails?

Apify retries transient errors. Per-country failures are logged and other countries continue.

#### 📅 Does it cover religious + cultural festivals?

Yes when those are official public holidays. For purely cultural festivals, results vary by country.

***

### 🔌 Integrate with any app

Public Holidays Worldwide Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets to Sheets

***

### 🔗 Recommended Actors

- [**🌍 REST Countries**](https://apify.com/parseforge/rest-countries-scraper) - Country reference data with capital, currency, flag
- [**🌐 GeoNames Places + Postal Codes**](https://apify.com/parseforge/geonames-places-scraper) - 12M+ places with admin hierarchy
- [**🌍 Open-Meteo Weather**](https://apify.com/parseforge/open-meteo-weather-scraper) - Global weather forecasts and historical climate
- [**🏥 WHO Global Health Indicators**](https://apify.com/parseforge/who-gho-health-indicators-scraper) - 9,000+ WHO health metrics
- [**🌏 World Bank Funded Projects**](https://apify.com/parseforge/worldbank-projects-scraper) - World Bank-financed development projects

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Nager.Date, its contributors, or any country's official public-holiday authority. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.

# Actor input Schema

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `country` (type: `string`):

Country to fetch. Empty = every supported country in chosen year.

## `yearStart` (type: `integer`):

Earliest year to fetch.

## `yearEnd` (type: `integer`):

Latest year. Empty = same as yearStart.

## Actor input object example

```json
{
  "maxItems": 10,
  "country": "US",
  "yearStart": 2026
}
```

# Actor output Schema

## `overview` (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 = {
    "maxItems": 10,
    "country": "US",
    "yearStart": 2026,
    "yearEnd": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/public-holidays-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 = {
    "maxItems": 10,
    "country": "US",
    "yearStart": 2026,
    "yearEnd": 0,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/public-holidays-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 '{
  "maxItems": 10,
  "country": "US",
  "yearStart": 2026,
  "yearEnd": 0
}' |
apify call parseforge/public-holidays-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/public-holidays-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Public Holidays Worldwide Scraper",
        "description": "Pull public holidays for 100+ countries by year. Returns date, local name, English name, country code, type (public/bank/optional), counties affected, and launch year. Multi-country runs and year ranges. Useful for HR, payroll, calendaring, and travel apps.",
        "version": "1.0",
        "x-build-id": "U5RRYy8Bdi61bXOKw"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~public-holidays-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-public-holidays-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/parseforge~public-holidays-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-public-holidays-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/parseforge~public-holidays-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-public-holidays-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",
                "properties": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "country": {
                        "title": "Country",
                        "enum": [
                            "",
                            "AL",
                            "AD",
                            "AR",
                            "AM",
                            "AU",
                            "AT",
                            "BS",
                            "BD",
                            "BB",
                            "BY",
                            "BE",
                            "BZ",
                            "BJ",
                            "BO",
                            "BA",
                            "BW",
                            "BR",
                            "BG",
                            "CA",
                            "CL",
                            "CN",
                            "CO",
                            "CG",
                            "CR",
                            "HR",
                            "CU",
                            "CY",
                            "CZ",
                            "CD",
                            "DK",
                            "DO",
                            "EC",
                            "EG",
                            "SV",
                            "EE",
                            "FO",
                            "FI",
                            "FR",
                            "GA",
                            "GM",
                            "GE",
                            "DE",
                            "GH",
                            "GI",
                            "GR",
                            "GL",
                            "GD",
                            "GT",
                            "GG",
                            "GY",
                            "HT",
                            "HN",
                            "HK",
                            "HU",
                            "IS",
                            "ID",
                            "IE",
                            "IM",
                            "IT",
                            "JM",
                            "JP",
                            "JE",
                            "KZ",
                            "KE",
                            "LV",
                            "LS",
                            "LI",
                            "LT",
                            "LU",
                            "MG",
                            "MT",
                            "MX",
                            "MD",
                            "MC",
                            "MN",
                            "ME",
                            "MS",
                            "MA",
                            "MZ",
                            "NA",
                            "NL",
                            "NZ",
                            "NI",
                            "NE",
                            "NG",
                            "MK",
                            "NO",
                            "PA",
                            "PG",
                            "PY",
                            "PE",
                            "PH",
                            "PL",
                            "PT",
                            "PR",
                            "RO",
                            "RU",
                            "SM",
                            "RS",
                            "SC",
                            "SG",
                            "SK",
                            "SI",
                            "ZA",
                            "KR",
                            "ES",
                            "SR",
                            "SJ",
                            "SE",
                            "CH",
                            "TN",
                            "TR",
                            "UG",
                            "UA",
                            "GB",
                            "US",
                            "UY",
                            "VA",
                            "VE",
                            "VN",
                            "ZW",
                            "AX"
                        ],
                        "type": "string",
                        "description": "Country to fetch. Empty = every supported country in chosen year.",
                        "default": ""
                    },
                    "yearStart": {
                        "title": "Year (or start of range)",
                        "minimum": 1900,
                        "type": "integer",
                        "description": "Earliest year to fetch."
                    },
                    "yearEnd": {
                        "title": "Year end (optional)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Latest year. Empty = same as yearStart."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
