# 🇸🇬 Singapore ACRA Companies — UEN & Director Lookup (`nexgendata/singapore-acra-companies`) Actor

Search Singapore ACRA corporate registry by name / UEN / entity type / status / incorporation date. Returns UEN, entity type, status, address, SSIC codes, paid-up capital, directors, auditor. KYC, AML, M\&A due diligence — Bloomberg/Refinitiv alternative.

- **URL**: https://apify.com/nexgendata/singapore-acra-companies.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $100.00 / 1,000 singapore acra company records

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

## 🇸🇬 Singapore ACRA Companies Search — UEN, Director & Corporate Registry Lookup

Search Singapore's **ACRA (Accounting and Corporate Regulatory Authority)** corporate registry — the canonical record of every entity legally incorporated in Singapore. Returns the company name, **UEN** (Unique Entity Number — Singapore's universal corporate identifier), entity type, registry status, incorporation date, registered address, **SSIC** business-activity codes, paid-up capital in SGD, directors, auditor, and last annual return date.

Singapore is the **financial gateway to Southeast Asia**. ACRA registrations are the legal ground-truth for KYC / AML compliance, M&A due diligence, regional VC sourcing, KYB onboarding, journalism, and sanctions screening across the ASEAN region. Every Sea Group, Grab, Shopee, ByteDance, Stripe, Razer, Lazada, Carro, Nium, and unicorn that touches Southeast Asia is registered with ACRA — and so is every regional family-office holding company, M&A SPV, and shell entity used to channel capital into the region. The UEN is to Singapore what the EIN is to the United States: the system-of-record identifier issued by the government, printed on every invoice, contract, and bank statement.

This Actor solves the BizFile+ search problem: ACRA's official portal, `bizfile.gov.sg`, is captcha-protected on company-detail pages, making programmatic lookup at scale difficult. We combine a best-effort live probe of BizFile+ with a curated, **publicly-disclosed** universe of Singapore's most-searched ~80 entities (SGX-listed companies, the major unicorns, the largest holding companies, regional subsidiaries of Big Tech, sovereign wealth vehicles, the well-known shell / SPV structures used by family offices) so you always get clean, structured data — even when BizFile+ rate-limits live scraping.

---

### What you get per row

Each dataset row is a single Singapore ACRA-registered entity:

- **`name`** — the canonical legal-entity name as registered with ACRA (uppercase, including suffix like `PTE. LTD.`, `LTD.`, `LIMITED`, `LLP`)
- **`uen`** — the Unique Entity Number, ACRA's 9-10 character system-of-record identifier (e.g. `201734933C` for Grab, `199901152M` for DBS Group Holdings). UENs are printed on every Singapore invoice and contract by law.
- **`entity_type`** — `PRIVATE_LIMITED` (Pte. Ltd. — Singapore's dominant form), `PUBLIC_LIMITED` (SGX-listed), `LLP` (limited liability partnership), `SOLE_PROPRIETOR`, `PARTNERSHIP`, `BRANCH` (foreign-incorporated entity registered in Singapore), `OTHER` (statutory boards and other special forms)
- **`status`** — `LIVE`, `STRUCK_OFF` (removed from the register, typically after >12 months of inactivity), `DISSOLVED` (formally wound up), `IN_LIQUIDATION` (currently being wound up), `DORMANT` (registered but not actively trading)
- **`incorporation_date`** — ISO format (`YYYY-MM-DD`)
- **`registered_address`** — the formal Singapore address on file at ACRA
- **`business_activities`** — list of **SSIC** (Singapore Standard Industrial Classification) codes with text descriptions
- **`paid_up_capital_sgd`** — paid-up share capital in Singapore Dollars (or `null` for branches and partnerships that don't have share capital)
- **`directors`** — list of currently registered directors
- **`auditor`** — currently appointed external auditor (Big Four firms account for most listed-company audits in Singapore)
- **`last_annual_return_date`** — ISO date of the most recent ACRA Annual Return filing
- **`data_source`** — `bizfile.gov.sg + curated ACRA disclosures`

---

### 8 use cases

1. **KYC / AML compliance** — Singapore is FATF-compliant and a MAS (Monetary Authority of Singapore) regulated jurisdiction. Before onboarding a Singapore counterparty, verify the entity is `LIVE` in ACRA, cross-check the UEN against the company's invoice header, and confirm the directors match the names on the W-9-equivalent KYC documents. If the UEN doesn't resolve or the status is `STRUCK_OFF`, that's an immediate red flag.

2. **M&A due diligence on SE Asian targets** — Hunt every entity matching a parent company's brand keyword to find Singapore-based subsidiaries, holding companies, regional HQs, and SPVs. Singapore is the legal home of most Southeast Asia VC funds and PE portfolio holding entities — if a Vietnamese, Indonesian, or Philippine startup raises USD venture capital, the cap table almost always runs through a Singapore Pte. Ltd. parent.

3. **Regional VC sourcing** — A new Stripe-Atlas-equivalent (Stripe Atlas now supports Singapore Pte. Ltd. formation; Carta and OSOME also register Singapore entities) shows up in ACRA *months* before Crunchbase has heard of it. Filter on `incorporation_date_from` within the last 90 days and `entity_type = PRIVATE_LIMITED` to surface fresh formations the moment they exist.

4. **Bloomberg / Refinitiv alternative** — Bloomberg's BVD and Refinitiv World-Check charge enterprise prices for the same UEN + director + auditor + paid-up-capital data that's public via ACRA. Two orders of magnitude cheaper at $0.10/company.

5. **KYB onboarding pipelines** — Fintech and SaaS companies onboarding Singapore SMB merchants need to verify the legal-entity name, UEN, and director list. Pipe the output straight into Snowflake / BigQuery as the source-of-truth for the KYB step.

6. **Sanctions / PEP screening (Politically Exposed Person)** — Cross-reference the `directors` field against sanctions lists (OFAC, EU consolidated, UK HMT) and PEP databases. Singapore is a known booking center for Indonesian, Chinese, and Malaysian wealth; a director name match warrants escalation.

7. **Journalism — shell-company & family-office tracking** — Singapore is a top-3 booking center globally (alongside Delaware and the Cayman Islands) for family-office SPVs and shell structures. Reporters covering corruption, tax evasion, or political donor networks use ACRA as the discovery layer.

8. **Corporate-governance research** — Map auditor concentration (Big Four vs. mid-tier), incorporation-date cohorts, paid-up capital distributions across SSIC sectors, and director interlock networks — feeding academic, policy, or activist-investor research.

---

### How this Actor compares (vs. enterprise alternatives)

| Provider | Singapore coverage | UEN lookup | Directors + Auditor | Annual cost | Per-record cost |
|---|---|---|---|---|---|
| **Bloomberg Terminal** | Yes (BVD module) | Yes | Yes | **~$30,000/year/seat** | (bundled — locked behind seat) |
| **S&P Capital IQ Pro** | Yes | Yes | Yes | **~$13,500/year/seat** | (bundled) |
| **Bureau van Dijk Orbis** | Yes (deep) | Yes | Yes | **~$50,000/year/enterprise** | (bundled) |
| **Refinitiv World-Check One** | Yes (KYC focus) | Yes | Yes (PEP overlay) | **~$10,000/year/seat** | (bundled) |
| **LexisNexis Diligence+** | Yes | Yes | Yes | **~$5,000+/year** | $25–$100/document |
| **ACRA BizFile+ (official)** | Yes (full) | Yes | Yes | Free signup | **S$5–S$55/document** + captcha at scale |
| **This Actor (nexgendata)** | Yes (top 80+ entities) | Yes | Yes | **None — PPE** | **$0.10/company** |

For directory-listing intel — KYC, AML, KYB, regional VC sourcing, deduping a counterparty list — this Actor is **two orders of magnitude cheaper** than enterprise BVD / Bloomberg / Refinitiv and far easier to integrate than scraping BizFile+ behind its captcha gate.

---

### Quick start (JSON input)

```json
{
  "search_query": "Grab",
  "entity_type": "ALL",
  "status": "LIVE",
  "limit": 10
}
````

#### Lookup a single UEN

```json
{ "uen": "199901152M" }
```

#### Find every Pte. Ltd. incorporated in 2024 (fresh VC sourcing)

```json
{
  "entity_type": "PRIVATE_LIMITED",
  "status": "LIVE",
  "incorporation_date_from": "2024-01-01",
  "incorporation_date_to": "2024-12-31",
  "limit": 500
}
```

#### Find every struck-off / dissolved entity (counterparty-risk sweep)

```json
{ "status": "STRUCK_OFF", "limit": 100 }
```

***

### Python SDK

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("nexgendata/singapore-acra-companies").call(run_input={
    "search_query": "DBS",
    "entity_type": "PUBLIC_LIMITED",
    "limit": 5,
})
for c in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{c['uen']} — {c['name']} ({c['status']}) — paid-up S${c.get('paid_up_capital_sgd')}")
```

### cURL

```bash
curl "https://api.apify.com/v2/acts/nexgendata~singapore-acra-companies/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uen":"201734933C"}'
```

***

### Integrations

Pipe results to **Zapier**, **Make.com**, or **n8n**. Common pairings: Salesforce / HubSpot enrichment for Singapore accounts; KYC pipelines into Snowflake / BigQuery / Databricks; webhook into Slack / Microsoft Teams for fresh-UEN alerts on newly-incorporated targets; cross-join with sanctions lists in Airtable for PEP screening.

***

### Pricing (Pay Per Event)

| Event | Price |
|---|---|
| Actor start | **$0.01** |
| Per company record returned | **$0.10** |

**Cost calculator:**

- 5 companies (smoke test) = **$0.51**
- 50 companies (a single KYC batch) = **$5.01**
- 200 companies (a small M\&A sweep) = **$20.01**
- 500 companies (regional VC scan) = **$50.01**
- 2,000 companies (large diligence project) = **$200.01**

Compare to Bloomberg / Refinitiv / BVD seat licences ($10K–$50K/year) or BizFile+ official document orders (S$5–S$55 per company × manual captcha solving). For directory-listing intel at scale this Actor is the cheapest commercial option in market.

***

### FAQ

**Is this the official BizFile+ / ACRA API?** No. ACRA's official BizFile+ portal at `bizfile.gov.sg` is captcha-gated on company-detail pages and offers paid document orders for full disclosure packages (S$5–S$55 per document). This Actor probes BizFile+ for liveness and falls back to a curated, publicly-disclosed universe drawn from SGX listings, the ACRA free-tier directory, public annual-return filings, and IPO prospectuses.

**Why a curated universe instead of full live scraping?** BizFile+ enforces aggressive rate-limits + captcha challenges that make full programmatic scraping infeasible at $0.10/company economics. The curated set covers ~80 of Singapore's most-searched entities — the SGX top 50 by market cap, the major unicorns, the largest holding companies, and a representative slice of branches / SPVs / partnerships / sole proprietors. For 90% of KYC / M\&A / VC-sourcing use cases this is exactly what you need. For full programmatic ACRA lookups you can use the UEN returned here as the seed for an official BizFile+ document order.

**Is the data accurate?** Every record is sourced from ACRA's free-tier directory, SGX disclosures, IPO prospectuses, or published annual returns — all public records. UENs are legally required to be printed on every invoice and website footer in Singapore, so they're already public information. We do not republish private filings.

**Are queries case-sensitive?** No. Both `search_query` and `uen` filters are case-insensitive.

**What if my search returns nothing?** Either no entity in our curated universe matches your filters, or the entity is registered but not in the top ~80. Use the official BizFile+ document-order service for the long tail of Singapore SMBs and SPVs, seeded by the UENs returned by this Actor.

**Is this dataset commercially usable?** The ACRA register is a public record published by a Singapore government statutory board. UENs, registered addresses, directors, and audit firms are public information by Companies Act mandate. Confirm your specific commercial use case with your legal team if you plan to redistribute the data.

***

### Related Actors

- 📈 [SGX Singapore Stock Screener](https://apify.com/nexgendata/sgx-singapore-stock-screener) — once you have the UEN, look up the SGX listing, share price, and market cap
- 🏛️ [Delaware Corporations Search Scraper](https://apify.com/nexgendata/delaware-corporations-search-scraper) — direct US parallel; many Singapore Pte. Ltd. entities have a Delaware C-corp parent for US VC
- 🇭🇰 [HKEX Hang Seng Stock Screener](https://apify.com/nexgendata/hkex-hang-seng-stock-screener) — pair with this Actor for full Greater China + SE Asia regional coverage
- 📑 [SEC Form 13F Holdings Tracker](https://apify.com/nexgendata/sec-form-13f-holdings-tracker) — US institutional positions in SGX-listed names
- 🦄 [Startup Funding Tracker](https://apify.com/nexgendata/startup-funding-tracker) — funding rounds downstream of a Singapore Pte. Ltd. incorporation event
- 🤖 [Finance MCP Server](https://apify.com/nexgendata/finance-mcp-server) — MCP-protocol financial-data server, useful for piping ACRA results into Claude / OpenAI / Cursor agents

***

[Try this Actor on Apify →](https://apify.com/nexgendata/singapore-acra-companies) | [Get a free Apify account →](https://apify.com/nexgendata?fpr=2ayu9b)

# Actor input Schema

## `search_query` (type: `string`):

Partial-match company-name search. Searches Singapore's ACRA corporate registry plus aggregated public lists (SGX-listed and Singapore's largest private companies). Leave empty to retrieve the full curated universe filtered by the other fields. Example: 'Sea', 'Grab', 'DBS'.

## `uen` (type: `string`):

Singapore's Unique Entity Number — the canonical 9-10 character ACRA-issued identifier for every registered Singapore entity (e.g. '201734933C' for Grab Holdings). Exact match. Takes precedence over search\_query when both are provided.

## `entity_type` (type: `string`):

Filter by ACRA entity type. 'ALL' returns everything. 'PRIVATE\_LIMITED' covers Pte. Ltd. — the dominant form. 'PUBLIC\_LIMITED' covers SGX-listed companies. 'LLP' is limited liability partnerships. 'SOLE\_PROPRIETOR' and 'PARTNERSHIP' are unincorporated forms.

## `status` (type: `string`):

Filter by registry status. 'LIVE' = currently active. 'STRUCK\_OFF' = removed from the register (typically inactive >12 months). 'DISSOLVED' = wound up. 'IN\_LIQUIDATION' = currently being wound up. 'ALL' returns every status.

## `incorporation_date_from` (type: `string`):

Lower bound on incorporation date in ISO format (YYYY-MM-DD). Use this together with `incorporation_date_to` to find newly-formed entities (VC sourcing) or vintage entities (legacy due diligence). Leave empty for no lower bound.

## `incorporation_date_to` (type: `string`):

Upper bound on incorporation date in ISO format (YYYY-MM-DD). Pair with `incorporation_date_from` to bound the formation window. Leave empty for no upper bound.

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

Hard cap on total companies returned in this run (1-2000). Each company is one dataset row. Premium pricing applies per row ($0.10/company).

## Actor input object example

```json
{
  "search_query": "Grab",
  "entity_type": "ALL",
  "status": "LIVE",
  "limit": 5
}
```

# 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 = {
    "search_query": "Grab",
    "uen": "",
    "entity_type": "ALL",
    "status": "LIVE",
    "incorporation_date_from": "",
    "incorporation_date_to": "",
    "limit": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/singapore-acra-companies").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 = {
    "search_query": "Grab",
    "uen": "",
    "entity_type": "ALL",
    "status": "LIVE",
    "incorporation_date_from": "",
    "incorporation_date_to": "",
    "limit": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/singapore-acra-companies").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 '{
  "search_query": "Grab",
  "uen": "",
  "entity_type": "ALL",
  "status": "LIVE",
  "incorporation_date_from": "",
  "incorporation_date_to": "",
  "limit": 5
}' |
apify call nexgendata/singapore-acra-companies --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/singapore-acra-companies",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🇸🇬 Singapore ACRA Companies — UEN & Director Lookup",
        "description": "Search Singapore ACRA corporate registry by name / UEN / entity type / status / incorporation date. Returns UEN, entity type, status, address, SSIC codes, paid-up capital, directors, auditor. KYC, AML, M&A due diligence — Bloomberg/Refinitiv alternative.",
        "version": "0.0",
        "x-build-id": "EDqIvfaZHPIazslc0"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgendata~singapore-acra-companies/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgendata-singapore-acra-companies",
                "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/nexgendata~singapore-acra-companies/runs": {
            "post": {
                "operationId": "runs-sync-nexgendata-singapore-acra-companies",
                "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/nexgendata~singapore-acra-companies/run-sync": {
            "post": {
                "operationId": "run-sync-nexgendata-singapore-acra-companies",
                "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": {
                    "search_query": {
                        "title": "Company name / keyword (partial match)",
                        "type": "string",
                        "description": "Partial-match company-name search. Searches Singapore's ACRA corporate registry plus aggregated public lists (SGX-listed and Singapore's largest private companies). Leave empty to retrieve the full curated universe filtered by the other fields. Example: 'Sea', 'Grab', 'DBS'."
                    },
                    "uen": {
                        "title": "UEN — Unique Entity Number (exact match)",
                        "type": "string",
                        "description": "Singapore's Unique Entity Number — the canonical 9-10 character ACRA-issued identifier for every registered Singapore entity (e.g. '201734933C' for Grab Holdings). Exact match. Takes precedence over search_query when both are provided."
                    },
                    "entity_type": {
                        "title": "Entity type",
                        "enum": [
                            "ALL",
                            "PRIVATE_LIMITED",
                            "PUBLIC_LIMITED",
                            "LLP",
                            "SOLE_PROPRIETOR",
                            "PARTNERSHIP",
                            "BRANCH",
                            "OTHER"
                        ],
                        "type": "string",
                        "description": "Filter by ACRA entity type. 'ALL' returns everything. 'PRIVATE_LIMITED' covers Pte. Ltd. — the dominant form. 'PUBLIC_LIMITED' covers SGX-listed companies. 'LLP' is limited liability partnerships. 'SOLE_PROPRIETOR' and 'PARTNERSHIP' are unincorporated forms.",
                        "default": "ALL"
                    },
                    "status": {
                        "title": "Entity status",
                        "enum": [
                            "ALL",
                            "LIVE",
                            "STRUCK_OFF",
                            "DISSOLVED",
                            "IN_LIQUIDATION",
                            "DORMANT"
                        ],
                        "type": "string",
                        "description": "Filter by registry status. 'LIVE' = currently active. 'STRUCK_OFF' = removed from the register (typically inactive >12 months). 'DISSOLVED' = wound up. 'IN_LIQUIDATION' = currently being wound up. 'ALL' returns every status.",
                        "default": "LIVE"
                    },
                    "incorporation_date_from": {
                        "title": "Incorporated on or after (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Lower bound on incorporation date in ISO format (YYYY-MM-DD). Use this together with `incorporation_date_to` to find newly-formed entities (VC sourcing) or vintage entities (legacy due diligence). Leave empty for no lower bound."
                    },
                    "incorporation_date_to": {
                        "title": "Incorporated on or before (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Upper bound on incorporation date in ISO format (YYYY-MM-DD). Pair with `incorporation_date_from` to bound the formation window. Leave empty for no upper bound."
                    },
                    "limit": {
                        "title": "Max companies returned",
                        "minimum": 1,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Hard cap on total companies returned in this run (1-2000). Each company is one dataset row. Premium pricing applies per row ($0.10/company).",
                        "default": 50
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```