# CVM Fundos de Investimento — Brazilian Investment Funds API (`jenko_systems/cvm-fundos-investimento`) Actor

Dados completos de fundos de investimento brasileiros (FI + FII + ETF) direto da CVM. Cadastro, informe diário, composição de carteira, ranking. Sem auth, dados sempre atualizados.

- **URL**: https://apify.com/jenko\_systems/cvm-fundos-investimento.md
- **Developed by:** [Jenko Systems](https://apify.com/jenko_systems) (community)
- **Categories:** Integrations, Automation, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$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.

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

## 📊 CVM Fundos de Investimento

API completa de **fundos de investimento brasileiros** (FI, FII, ETF) com dados oficiais da CVM, enriquecidos com tickers da B3.

> 🇺🇸 **English version below** ⬇️

---

### 🇧🇷 Visão Geral

Acesso unificado a **130.000+ fundos** brasileiros — cadastro, cotas diárias, composição de carteira, ranking por PL/captação/rentabilidade e busca por gestor/administrador. Dados sempre frescos, baixados direto da CVM a cada execução.

#### O que tem:
- ✅ **130k+ fundos** cadastrados (RCVM 175 + legado)
- ✅ **FI, FII, ETF, FIDC, FIP, FIAGRO** — todos os tipos
- ✅ **Tickers B3** automáticos pra FIIs (HGLG11, KNRI11, MXRF11...)
- ✅ **Histórico desde 2020** — cotas, PL, captação, cotistas
- ✅ **Composição de carteira** (CDA) — 8 blocos de ativos
- ✅ **Ranking nacional** por patrimônio, captação, rentabilidade
- ✅ **Sem autenticação** na CVM, dados 100% públicos

#### Casos de uso:
- 📈 Plataformas de investimento (mostrar info de fundos)
- 📊 Dashboards de análise (ranking, comparação)
- 🔍 Compliance/KYC (verificar gestor/administrador)
- 📰 Reportagens financeiras (top fundos por categoria)
- 🤖 Automação de relatórios mensais

---

---

### 🚀 Modos de Operação

O actor tem **5 modos**, escolhidos via parâmetro `mode`:

#### 1️⃣ `search_funds` — Busca de fundos no cadastro

Busca por nome, ticker, CNPJ, tipo, classe, situação ou administrador.

```json
{
  "mode": "search_funds",
  "name_contains": "VERDE",
  "fund_type": "FI",
  "situation": "EM FUNCIONAMENTO NORMAL",
  "limit": 50
}
````

**Resposta** (exemplo simplificado):

```json
[
  {
    "cnpj": "44803273000140",
    "cnpj_formatted": "44.803.273/0001-40",
    "name": "ACCESS VERDE FIE PREVIDÊNCIA FUNDO DE INVESTIMENTO MULTIMERCADO",
    "fund_type": "FI",
    "situation": "EM FUNCIONAMENTO NORMAL",
    "registration_date": "2022-05-03",
    "manager_name": "BTG PACTUAL GESTÃO E CONSULTORIA",
    "administrator_name": "BTG PACTUAL SERVIÇOS FINANCEIROS S/A DTVM"
  }
]
```

#### 2️⃣ `fund_daily` — Informe diário (cota, PL, captação)

Histórico diário de um fundo (FI/ETF) ou mensal (FII).

```json
{
  "mode": "fund_daily",
  "cnpj": "07.096.546/0001-37",
  "from_date": "2024-01-01",
  "to_date": "2024-12-31"
}
```

**Resposta**:

```json
[
  {
    "cnpj": "07096546000137",
    "date": "2024-01-02",
    "share_value": 53.842966,
    "net_worth": 194934474.96,
    "subscription": 266530.75,
    "redemption": 7958900.78,
    "shareholders_count": 253,
    "fund_name": "ITAÚ CAIXA AÇÕES FUNDO DE INVESTIMENTO FINANCEIRO"
  }
]
```

#### 3️⃣ `fund_portfolio` — Composição de carteira (CDA)

Lista todos os ativos da carteira de um fundo num mês de referência.

```json
{
  "mode": "fund_portfolio",
  "cnpj": "07.096.546/0001-37",
  "month": "2024-09"
}
```

**Resposta**:

```json
[
  {
    "cnpj": "07096546000137",
    "asset_type": "Investimentos diversos",
    "market_value": 25527984.76,
    "pct_of_portfolio": 10.59,
    "due_date": "2026-08-15",
    "block_number": 1,
    "reference_month": "2024-09"
  }
]
```

#### 4️⃣ `ranking` — Top fundos por métrica

Ranking nacional por **patrimônio líquido**, **captação líquida**, **rentabilidade** ou **número de cotistas**.

```json
{
  "mode": "ranking",
  "ranking_metric": "patrimonio_liquido",
  "ranking_period": "2024-12_2024-12",
  "fund_type": "FI",
  "limit": 10
}
```

**Resposta**:

```json
[
  {
    "rank": 1,
    "cnpj": "07593972000186",
    "name": "BRASILPREV TOP TPF FUNDO DE INVESTIMENTO FINANCEIRO RENDA FIXA",
    "net_worth": 206564420627.40,
    "metric": "patrimonio_liquido",
    "last_date": "2024-12-31"
  }
]
```

**Métricas suportadas**: `patrimonio_liquido` | `captacao_liquida` | `rentabilidade` | `n_cotistas`

#### 5️⃣ `manager_funds` — Fundos de um gestor/administrador

Lista todos os fundos de um gestor ou administrador (busca por CNPJ).

```json
{
  "mode": "manager_funds",
  "manager_cnpj": "59.281.253/0001-23",
  "fund_type": "FI",
  "limit": 100
}
```

**Resposta**: lista de fundos com mesmo formato do `search_funds`.

***

### 📋 Parâmetros completos

| Parâmetro | Tipo | Default | Descrição |
|---|---|---|---|
| `mode` | string | `search_funds` | Modo de operação (5 valores) |
| `cnpj` | string | — | CNPJ do fundo (com ou sem formatação) |
| `manager_cnpj` | string | — | CNPJ do gestor/administrador |
| `name_contains` | string | — | Filtro por nome ou ticker (HGLG, KNRI, etc) |
| `fund_type` | string | `ALL` | `FI`, `FII`, `ETF` ou `ALL` |
| `class_anbima` | string | — | Filtro por classe ANBIMA/CVM |
| `situation` | string | `EM FUNCIONAMENTO NORMAL` | Situação do fundo |
| `from_date` | string | — | Data inicial (YYYY-MM-DD) |
| `to_date` | string | hoje | Data final (YYYY-MM-DD) |
| `month` | string | últimos 3m | Mês de referência (YYYY-MM) |
| `ranking_metric` | string | `patrimonio_liquido` | Métrica do ranking |
| `ranking_period` | string | últimos 12m | Período (YYYY-MM\_YYYY-MM) |
| `limit` | integer | 10000 | Máx. records (até 100000) |

***

### 🔧 Como rodar

#### Via Apify Console

1. Cole o JSON de input no editor
2. Clique em **"Start"**
3. Resultado disponível no **Dataset**

#### Via API

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/jenko_systems~cvm-fundos-investimento/run-sync-get-dataset-items?token=SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search_funds",
    "name_contains": "HGLG",
    "fund_type": "FII",
    "limit": 10
  }'
```

#### Via Apify SDK (Python)

```python
from apify_client import ApifyClient

client = ApifyClient("SEU_TOKEN")

run = client.actor("jenko_systems/cvm-fundos-investimento").call(run_input={
    "mode": "ranking",
    "ranking_metric": "patrimonio_liquido",
    "fund_type": "FI",
    "limit": 50
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

***

### ⚠️ Notas importantes

- **Tickers FII**: cobertura ~94% dos FIIs ativos. Em casos raros (fundo trocou de gestor) o ticker pode estar associado ao nome anterior. Use **CNPJ** pra busca infalível.
- **Histórico**: dados disponíveis desde **2020-01-01**. Anos anteriores não são suportados.
- **Composição (CDA)**: defasagem regulatória de ~3 meses. Pra mês corrente, dado pode não estar disponível.
- **CDA de FII**: ainda não implementada. Use `fund_daily` pra dados mensais de FII.
- **Tempo de resposta**: 30-90s típico (download de arquivos grandes da CVM). Cache interno acelera execuções subsequentes.

***

### 📚 Fontes de dados

- **CVM Dados Abertos** — https://dados.cvm.gov.br/dataset/fi-cad
- **Resolução CVM 175** — cadastro novo (registro\_fundo.csv)
- **Cadastro legado** — fundos não adaptados RCVM 175
- **fiis.com.br** — mapeamento ticker B3 ↔ FII

***

***

### 🇺🇸 English Version

#### Overview

Unified API for **130,000+ Brazilian investment funds** (FI = open-ended funds, FII = real estate funds, ETF) with official data from CVM (Brazilian SEC equivalent), enriched with B3 (Brazilian stock exchange) tickers.

#### What you get:

- ✅ **130k+ funds** registered (post-2024 RCVM 175 + legacy)
- ✅ **FI, FII, ETF, FIDC, FIP, FIAGRO** — all fund types
- ✅ **B3 tickers** auto-matched for FIIs (HGLG11, KNRI11, MXRF11...)
- ✅ **History since 2020** — share value, NAV, inflows, holders count
- ✅ **Portfolio composition** (CDA) — 8 asset blocks
- ✅ **National rankings** by NAV, inflows, returns
- ✅ **No authentication** — CVM data is fully public

#### 5 Operation Modes

| Mode | Description |
|---|---|
| `search_funds` | Search by name, ticker, CNPJ, type, class |
| `fund_daily` | Daily report (share value, NAV, flows, holders) |
| `fund_portfolio` | Asset composition (CDA) for a reference month |
| `ranking` | Top funds by metric (NAV, inflows, returns, holders) |
| `manager_funds` | All funds managed/administered by a given CNPJ |

#### Quick Example (cURL)

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/jenko_systems~cvm-fundos-investimento/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search_funds",
    "name_contains": "HGLG",
    "fund_type": "FII"
  }'
```

#### Important Notes

- **FII tickers**: ~94% coverage. Rare cases of fund manager change may misassociate ticker. Use **CNPJ** for reliable lookups.
- **History**: data available since **2020-01-01**. Earlier years not supported.
- **Portfolio (CDA)**: ~3 months regulatory delay. Current month data may not be available.
- **FII portfolio**: not implemented yet. Use `fund_daily` for FII monthly data.

#### Data Sources

- **CVM Open Data Portal** — https://dados.cvm.gov.br/dataset/fi-cad
- **B3 Listed Funds** (via fiis.com.br) — for FII ticker mapping

***

Built with 🇧🇷 by [Jenko Systems](https://jenkosystems.com) — affordable, unauthenticated APIs for Brazilian public data.

# Actor input Schema

## `mode` (type: `string`):

Tipo de consulta: search\_funds (busca cadastro), fund\_daily (informe diário), fund\_portfolio (composição de carteira), ranking (top fundos), manager\_funds (fundos de um gestor)

## `cnpj` (type: `string`):

CNPJ do fundo. Aceita com ou sem formatação (12.345.678/0001-90 ou 12345678000190). Obrigatório para fund\_daily e fund\_portfolio.

## `name_contains` (type: `string`):

Filtra fundos cujo nome contém este texto (case insensitive). Exemplo: 'VERDE' retorna todos os fundos da Verde Asset.

## `fund_type` (type: `string`):

Filtra por tipo: FI (multimercado, RF, ações, etc), FII (imobiliários), ETF, ou ALL para todos

## `class_anbima` (type: `string`):

Filtra por classificação ANBIMA do fundo (ex: 'Multimercado Macro', 'Renda Fixa Duration Livre Soberano')

## `situation` (type: `string`):

Filtra por situação cadastral

## `from_date` (type: `string`):

Data inicial para informe diário (formato YYYY-MM-DD). Mínimo: 2020-01-01.

## `to_date` (type: `string`):

Data final para informe diário (formato YYYY-MM-DD). Padrão: hoje.

## `month` (type: `string`):

Mês para composição de carteira (formato YYYY-MM). Padrão: último disponível.

## `manager_cnpj` (type: `string`):

CNPJ do gestor ou administrador. Obrigatório para mode=manager\_funds.

## `ranking_metric` (type: `string`):

Métrica para ordenar o ranking

## `ranking_period` (type: `string`):

Período para o ranking (formato YYYY-MM\_YYYY-MM). Exemplo: 2024-01\_2024-12

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

Máximo de records a retornar (proteção contra cobranças surpresa). Default: 10000, máximo: 100000.

## Actor input object example

```json
{
  "mode": "search_funds",
  "fund_type": "ALL",
  "situation": "EM FUNCIONAMENTO NORMAL",
  "ranking_metric": "patrimonio_liquido",
  "limit": 10000
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset contendo os fundos/informes/posições consultados

## `consulta` (type: `string`):

Input usado nesta run

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("jenko_systems/cvm-fundos-investimento").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("jenko_systems/cvm-fundos-investimento").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 '{}' |
apify call jenko_systems/cvm-fundos-investimento --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jenko_systems/cvm-fundos-investimento",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "CVM Fundos de Investimento — Brazilian Investment Funds API",
        "description": "Dados completos de fundos de investimento brasileiros (FI + FII + ETF) direto da CVM. Cadastro, informe diário, composição de carteira, ranking. Sem auth, dados sempre atualizados.",
        "version": "1.0",
        "x-build-id": "Dg1gBgvjHjp6swuuU"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/jenko_systems~cvm-fundos-investimento/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-jenko_systems-cvm-fundos-investimento",
                "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/jenko_systems~cvm-fundos-investimento/runs": {
            "post": {
                "operationId": "runs-sync-jenko_systems-cvm-fundos-investimento",
                "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/jenko_systems~cvm-fundos-investimento/run-sync": {
            "post": {
                "operationId": "run-sync-jenko_systems-cvm-fundos-investimento",
                "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": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Modo de execução",
                        "enum": [
                            "search_funds",
                            "fund_daily",
                            "fund_portfolio",
                            "ranking",
                            "manager_funds"
                        ],
                        "type": "string",
                        "description": "Tipo de consulta: search_funds (busca cadastro), fund_daily (informe diário), fund_portfolio (composição de carteira), ranking (top fundos), manager_funds (fundos de um gestor)",
                        "default": "search_funds"
                    },
                    "cnpj": {
                        "title": "CNPJ do fundo",
                        "type": "string",
                        "description": "CNPJ do fundo. Aceita com ou sem formatação (12.345.678/0001-90 ou 12345678000190). Obrigatório para fund_daily e fund_portfolio."
                    },
                    "name_contains": {
                        "title": "Nome contém",
                        "type": "string",
                        "description": "Filtra fundos cujo nome contém este texto (case insensitive). Exemplo: 'VERDE' retorna todos os fundos da Verde Asset."
                    },
                    "fund_type": {
                        "title": "Tipo de fundo",
                        "enum": [
                            "ALL",
                            "FI",
                            "FII",
                            "ETF"
                        ],
                        "type": "string",
                        "description": "Filtra por tipo: FI (multimercado, RF, ações, etc), FII (imobiliários), ETF, ou ALL para todos",
                        "default": "ALL"
                    },
                    "class_anbima": {
                        "title": "Classe ANBIMA",
                        "type": "string",
                        "description": "Filtra por classificação ANBIMA do fundo (ex: 'Multimercado Macro', 'Renda Fixa Duration Livre Soberano')"
                    },
                    "situation": {
                        "title": "Situação",
                        "enum": [
                            "ALL",
                            "EM FUNCIONAMENTO NORMAL",
                            "FASE PRE-OPERACIONAL",
                            "CANCELADA",
                            "EM LIQUIDACAO"
                        ],
                        "type": "string",
                        "description": "Filtra por situação cadastral",
                        "default": "EM FUNCIONAMENTO NORMAL"
                    },
                    "from_date": {
                        "title": "Data inicial",
                        "type": "string",
                        "description": "Data inicial para informe diário (formato YYYY-MM-DD). Mínimo: 2020-01-01."
                    },
                    "to_date": {
                        "title": "Data final",
                        "type": "string",
                        "description": "Data final para informe diário (formato YYYY-MM-DD). Padrão: hoje."
                    },
                    "month": {
                        "title": "Mês de referência",
                        "pattern": "^\\d{4}-\\d{2}$",
                        "type": "string",
                        "description": "Mês para composição de carteira (formato YYYY-MM). Padrão: último disponível."
                    },
                    "manager_cnpj": {
                        "title": "CNPJ do gestor/administrador",
                        "type": "string",
                        "description": "CNPJ do gestor ou administrador. Obrigatório para mode=manager_funds."
                    },
                    "ranking_metric": {
                        "title": "Métrica do ranking",
                        "enum": [
                            "patrimonio_liquido",
                            "captacao_liquida",
                            "rentabilidade",
                            "n_cotistas"
                        ],
                        "type": "string",
                        "description": "Métrica para ordenar o ranking",
                        "default": "patrimonio_liquido"
                    },
                    "ranking_period": {
                        "title": "Período do ranking",
                        "type": "string",
                        "description": "Período para o ranking (formato YYYY-MM_YYYY-MM). Exemplo: 2024-01_2024-12"
                    },
                    "limit": {
                        "title": "Limite de records",
                        "minimum": 1,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Máximo de records a retornar (proteção contra cobranças surpresa). Default: 10000, máximo: 100000.",
                        "default": 10000
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```