# Foreclosed Properties List (emails) (`kawsar/foreclosed-properties-list-emails`) Actor

Foreclosed properties list tool that extracts distressed real estate inventory across the US, giving investors direct access to off-market and foreclosure deals.

- **URL**: https://apify.com/kawsar/foreclosed-properties-list-emails.md
- **Developed by:** [Kawsar](https://apify.com/kawsar) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 results

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

## Foreclosed Properties List: Find Distressed Deals and Bank-Owned Homes

Access an up-to-date foreclosed properties list with a few simple parameters. Finding distressed properties usually involves paying high monthly subscriptions to niche real estate platforms or manually digging through county records. We built this tool to pull active foreclosures directly into a clean, structured JSON format so you can run your own analysis.

Instead of navigating clunky interfaces, you type in a zip code or state, and get back exactly what properties are currently in foreclosure or recently sold. 

### Use cases

- **Wholesaling**: pull a fresh foreclosed properties list for a specific zip code to target distressed sellers.
- **Investment analysis**: export recent sold properties to accurately build a Comparative Market Analysis without manual data entry.
- **Lead generation**: extract direct agent contact details representing bank-owned properties.
- **Market monitoring**: run automated daily checks for new foreclosures entering the market in your target neighborhoods.

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `postal_code` | string | — | US ZIP code. Most precise location filter. Example: `90210`. |
| `state_code` | string | — | 2-letter US state code. Example: `TX`. |
| `city` | string | — | City name. Example: `Houston`. |
| `propertyType` | array | — | Property types. Options: `single_family`, `condo_townhome`, etc. |
| `beds_min` / `beds_max` | integer | — | Filter by bedroom count. |
| `list_price_min` / `max` | integer | — | Active asking price range in USD. |
| `sold_price_max` | integer | — | Max sold price (only applies to sold properties). |
| `maxItems` | integer | `5000` | Total maximum properties to extract per run. |
| `proxyConfiguration` | object | Datacenter | Proxy settings to use for requests. Leave as default unless experiencing blocking. |

### Example Input

This example pulls a foreclosed properties list in Texas, specifically single-family homes under $300,000.

```json
{
    "state_code": "TX",
    "propertyType": ["single_family"],
    "list_price_max": 300000,
    "maxItems": 200,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
}
````

### Output Fields Explained

The actor outputs flattened, easy-to-use JSON objects for each property.

| Field | Type | Description |
|-------|------|-------------|
| `property_id` | string | Internal permanent identifier for the listing |
| `listing_id` | string | Internal listing ID associated with the property source |
| `permalink` | string | The direct slug for the listing (useful to build relative URLs) |
| `status` | string | Either `for_sale` or `sold` |
| `list_price` | integer | The current asking price in USD |
| `sold_price` | integer | Final sold price in USD (only applicable if sold) |
| `price_reduced_amount` | integer | Amount the property has been discounted |
| `list_date` | string | The ISO 8601 date the listing hit the market |
| `sold_date` | string | The ISO 8601 date the listing closed (if applicable) |
| `type` / `sub_type` | string | Classification of property (single\_family, condo, etc.) |
| `beds` / `baths_consolidated` | integer | Bedroom and bathroom counts |
| `sqft` | integer | Total interior square footage |
| `lot_sqft` | integer | Total exterior land square footage |
| `year_built` | integer | The year the property was originally constructed |
| `garage` | integer | Number of garage spaces |
| `address_line` | string | The full street address of the property |
| `city` / `state` / `state_code` / `postal_code` | string | Detailed address properties |
| `latitude` / `longitude` | number | Exact GPS coordinates |
| `county_name` / `county_fips` | string | Property county information, excellent for demographic matches |
| `street_view_url` | string | Link to Google Maps street view preview of the property |
| `primary_photo_url` | string | Direct link to the featured display image |
| `photo_count` | integer | Total number of photos associated with the property |
| `photo_urls` | array | A list of direct image links for the property |
| `matterport` | boolean | True if the property contains a matterport 3d walk-through |
| `is_foreclosure` | boolean | Always `true` for active foreclosure listings |
| `is_coming_soon` / `is_new_listing` / `is_price_reduced` / `is_pending` / `is_contingent` / `is_auction` / `is_fractionally_owned` | boolean | Secondary transactional lifecycle flags and property indicators |
| `source_id` / `source_name` / `source_type` / `source_listing_id` | string | Specific source integrations the property was aggregated from (eg. the standard MLS) |
| `advertiser_1_name` / `advertiser_2_name` | string | Name of the primary and secondary listing agent/representative |
| `advertiser_1_email` / `advertiser_2_email` | string | Direct contact emails for the representatives |
| `advertiser_1_office` / `advertiser_2_office` | string | The parent office handling the representation (eg. Keller Williams) |
| `advertiser_1_phones` / `advertiser_2_phones` | array | Phone numbers for the primary and secondary contacts |
| `branding_name` | string | Optional affiliated agent branding profile details |
| `open_houses` | array | Array containing start\_date, end\_date, timezone, and description for viewing events |
| `community_promotions` / `search_promotions` | array | Array detailing additional marketing or platform property promotions |
| `lead_show_contact_an_agent` / `lead_market_type` / `lead_type` / `is_veterans_united_eligible` | mixed | Underlying lead generation attributes the listing platform utilizes |
| `products_list` / `products_brand_name` | mixed | Agent tier and listing distribution products pushed by the API |
| `rmn_listing_attribution` | boolean | Sourcing attribution parameter |
| `scrapedAt` | string | ISO timestamp outlining when the row was extracted |
| `error` | string | Exception details if the extraction run caught an issue during parse |

### FAQ

**Where is the data coming from?**
The tool extracts property data from major public real estate networks, specifically filtering for listings marked as distressed or in foreclosure.

**Is this only for foreclosures?**
Yes. Under the hood, this scraper is hardcoded to only return properties explicitly flagged as foreclosures. This guarantees your results aren't cluttered with standard retail listings.

**Can I get sold comps?**
Yes. You can supply a `sold_date_min` to find recent sold foreclosure properties for making accurate offers.

# Actor input Schema

## `postal_code` (type: `string`):

Filter properties exactly by a 5-digit US ZIP or postal code. This is the most reliable way to target a specific neighborhood. Example: '90210' for Beverly Hills, CA.

## `state_code` (type: `string`):

Filter properties broadly by a 2-letter US state code. Best used in combination with other filters. Example: 'CA' for California, 'NY' for New York.

## `city` (type: `string`):

Filter properties by the exact city name. Usually best to combine with state\_code. Example: 'Los Angeles' or 'Austin'.

## `street_name` (type: `string`):

Target properties located on a specific street name. Example: 'Sunset Blvd' or 'Main St'.

## `address` (type: `string`):

Filter for a very specific property address line. Example: '123 Fake Street'.

## `propertyType` (type: `array`):

Filter the results by specific property types. Supported options include: apartment, condo\_townhome, condo\_townhome\_rowhome\_coop, condo, condos, single\_family, multi\_family, mobile, land, farm, other.

## `keywords` (type: `array`):

Filter properties by specific amenities or descriptive features. Options include: basement, carport, central\_air, den, hardwood\_floors, pool, waterfront, ocean\_view, fireplace.

## `beds_min` (type: `integer`):

Minimum threshold for the number of bedrooms.

## `beds_max` (type: `integer`):

Maximum threshold for the number of bedrooms.

## `baths_min` (type: `integer`):

Minimum threshold for the number of bathrooms (including half-baths).

## `baths_max` (type: `integer`):

Maximum threshold for the number of bathrooms.

## `list_price_min` (type: `integer`):

Minimum active asking list price in USD.

## `list_price_max` (type: `integer`):

Maximum active asking list price in USD.

## `sold_price_min` (type: `integer`):

Minimum sold price in USD.

## `sold_price_max` (type: `integer`):

Maximum sold price in USD.

## `sold_date_min` (type: `string`):

Earliest date the property was sold in YYYY-MM-DD format.

## `sold_date_max` (type: `string`):

Latest date the property was sold in YYYY-MM-DD format.

## `sqft_min` (type: `integer`):

Minimum interior (living space) square footage.

## `sqft_max` (type: `integer`):

Maximum interior (living space) square footage.

## `lot_sqft_min` (type: `integer`):

Minimum exterior lot size in square feet.

## `lot_sqft_max` (type: `integer`):

Maximum exterior lot size in square feet.

## `year_built_min` (type: `integer`):

Filter by the year the construction was completed.

## `year_built_max` (type: `integer`):

Set a maximum year of completion to target historic or older builds.

## `hoa_fee_max` (type: `integer`):

Maximum Homeowners Association monthly fee allowed.

## `no_hoa_fee` (type: `boolean`):

Check this box to exclusively show properties that have absolutely no Homeowners Association fee attached.

## `open_house_min` (type: `string`):

Filter for properties with scheduled open houses from this date onward (Format: YYYY-MM-DD).

## `open_house_max` (type: `string`):

Filter for properties with scheduled open houses up until this date (Format: YYYY-MM-DD).

## `limit` (type: `integer`):

The number of listings fetched in a single API call.

## `offset` (type: `integer`):

The exact positional index the scraper starts at.

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

The hard cap on total listings the scraper will collect across all paginated API calls.

## `timeoutSecs` (type: `integer`):

If the scraper surpasses this runtime duration, it will safely halt and exit.

## `requestTimeoutSecs` (type: `integer`):

How long the scraper waits for the server to respond per API query slice.

## `proxyConfiguration` (type: `object`):

Select proxies to obscure IP and evade blocking. Note: USA datacenter proxy is set as the default.

## Actor input object example

```json
{
  "postal_code": "90210",
  "state_code": "CA",
  "city": "Los Angeles",
  "propertyType": [
    "condo_townhome",
    "single_family"
  ],
  "keywords": [
    "basement",
    "pool"
  ],
  "beds_min": 1,
  "beds_max": 5,
  "baths_min": 1,
  "list_price_min": 200000,
  "list_price_max": 900000,
  "sold_date_min": "2022-03-25",
  "sold_date_max": "2022-09-25",
  "year_built_min": 2017,
  "year_built_max": 2023,
  "no_hoa_fee": false,
  "limit": 200,
  "offset": 0,
  "maxItems": 5000,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  }
}
```

# 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 = {
    "state_code": "CA",
    "city": "Los Angeles",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("kawsar/foreclosed-properties-list-emails").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 = {
    "state_code": "CA",
    "city": "Los Angeles",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("kawsar/foreclosed-properties-list-emails").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 '{
  "state_code": "CA",
  "city": "Los Angeles",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  }
}' |
apify call kawsar/foreclosed-properties-list-emails --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=kawsar/foreclosed-properties-list-emails",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Foreclosed Properties List (emails)",
        "description": "Foreclosed properties list tool that extracts distressed real estate inventory across the US, giving investors direct access to off-market and foreclosure deals.",
        "version": "0.0",
        "x-build-id": "RS7N4cvcQTUlWIwHI"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/kawsar~foreclosed-properties-list-emails/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-kawsar-foreclosed-properties-list-emails",
                "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/kawsar~foreclosed-properties-list-emails/runs": {
            "post": {
                "operationId": "runs-sync-kawsar-foreclosed-properties-list-emails",
                "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/kawsar~foreclosed-properties-list-emails/run-sync": {
            "post": {
                "operationId": "run-sync-kawsar-foreclosed-properties-list-emails",
                "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": {
                    "postal_code": {
                        "title": "Postal code",
                        "type": "string",
                        "description": "Filter properties exactly by a 5-digit US ZIP or postal code. This is the most reliable way to target a specific neighborhood. Example: '90210' for Beverly Hills, CA."
                    },
                    "state_code": {
                        "title": "State code",
                        "type": "string",
                        "description": "Filter properties broadly by a 2-letter US state code. Best used in combination with other filters. Example: 'CA' for California, 'NY' for New York."
                    },
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "Filter properties by the exact city name. Usually best to combine with state_code. Example: 'Los Angeles' or 'Austin'."
                    },
                    "street_name": {
                        "title": "Street name",
                        "type": "string",
                        "description": "Target properties located on a specific street name. Example: 'Sunset Blvd' or 'Main St'."
                    },
                    "address": {
                        "title": "Address",
                        "type": "string",
                        "description": "Filter for a very specific property address line. Example: '123 Fake Street'."
                    },
                    "propertyType": {
                        "title": "Property type",
                        "type": "array",
                        "description": "Filter the results by specific property types. Supported options include: apartment, condo_townhome, condo_townhome_rowhome_coop, condo, condos, single_family, multi_family, mobile, land, farm, other.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "keywords": {
                        "title": "Feature keywords",
                        "type": "array",
                        "description": "Filter properties by specific amenities or descriptive features. Options include: basement, carport, central_air, den, hardwood_floors, pool, waterfront, ocean_view, fireplace.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "beds_min": {
                        "title": "Min bedrooms",
                        "type": "integer",
                        "description": "Minimum threshold for the number of bedrooms."
                    },
                    "beds_max": {
                        "title": "Max bedrooms",
                        "type": "integer",
                        "description": "Maximum threshold for the number of bedrooms."
                    },
                    "baths_min": {
                        "title": "Min bathrooms",
                        "type": "integer",
                        "description": "Minimum threshold for the number of bathrooms (including half-baths)."
                    },
                    "baths_max": {
                        "title": "Max bathrooms",
                        "type": "integer",
                        "description": "Maximum threshold for the number of bathrooms."
                    },
                    "list_price_min": {
                        "title": "Min list price",
                        "type": "integer",
                        "description": "Minimum active asking list price in USD."
                    },
                    "list_price_max": {
                        "title": "Max list price",
                        "type": "integer",
                        "description": "Maximum active asking list price in USD."
                    },
                    "sold_price_min": {
                        "title": "Min sold price",
                        "type": "integer",
                        "description": "Minimum sold price in USD."
                    },
                    "sold_price_max": {
                        "title": "Max sold price",
                        "type": "integer",
                        "description": "Maximum sold price in USD."
                    },
                    "sold_date_min": {
                        "title": "Sold date from",
                        "type": "string",
                        "description": "Earliest date the property was sold in YYYY-MM-DD format."
                    },
                    "sold_date_max": {
                        "title": "Sold date to",
                        "type": "string",
                        "description": "Latest date the property was sold in YYYY-MM-DD format."
                    },
                    "sqft_min": {
                        "title": "Min square feet",
                        "type": "integer",
                        "description": "Minimum interior (living space) square footage."
                    },
                    "sqft_max": {
                        "title": "Max square feet",
                        "type": "integer",
                        "description": "Maximum interior (living space) square footage."
                    },
                    "lot_sqft_min": {
                        "title": "Min lot square feet",
                        "type": "integer",
                        "description": "Minimum exterior lot size in square feet."
                    },
                    "lot_sqft_max": {
                        "title": "Max lot square feet",
                        "type": "integer",
                        "description": "Maximum exterior lot size in square feet."
                    },
                    "year_built_min": {
                        "title": "Year built from",
                        "type": "integer",
                        "description": "Filter by the year the construction was completed."
                    },
                    "year_built_max": {
                        "title": "Year built to",
                        "type": "integer",
                        "description": "Set a maximum year of completion to target historic or older builds."
                    },
                    "hoa_fee_max": {
                        "title": "Max HOA fee",
                        "type": "integer",
                        "description": "Maximum Homeowners Association monthly fee allowed."
                    },
                    "no_hoa_fee": {
                        "title": "No HOA fee",
                        "type": "boolean",
                        "description": "Check this box to exclusively show properties that have absolutely no Homeowners Association fee attached.",
                        "default": false
                    },
                    "open_house_min": {
                        "title": "Open house from",
                        "type": "string",
                        "description": "Filter for properties with scheduled open houses from this date onward (Format: YYYY-MM-DD)."
                    },
                    "open_house_max": {
                        "title": "Open house to",
                        "type": "string",
                        "description": "Filter for properties with scheduled open houses up until this date (Format: YYYY-MM-DD)."
                    },
                    "limit": {
                        "title": "Results per pagination page",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "The number of listings fetched in a single API call.",
                        "default": 200
                    },
                    "offset": {
                        "title": "Initial page offset",
                        "minimum": 0,
                        "type": "integer",
                        "description": "The exact positional index the scraper starts at.",
                        "default": 0
                    },
                    "maxItems": {
                        "title": "Maximum total results to scrape",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "The hard cap on total listings the scraper will collect across all paginated API calls.",
                        "default": 5000
                    },
                    "timeoutSecs": {
                        "title": "Overall actor timeout (seconds)",
                        "minimum": 30,
                        "maximum": 3600,
                        "type": "integer",
                        "description": "If the scraper surpasses this runtime duration, it will safely halt and exit.",
                        "default": 300
                    },
                    "requestTimeoutSecs": {
                        "title": "Per-request timeout (seconds)",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "How long the scraper waits for the server to respond per API query slice.",
                        "default": 30
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to obscure IP and evade blocking. Note: USA datacenter proxy is set as the default."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
