# Korean Business Data — BRN Validator & Enricher (`lazymac/korean-business-data`) Actor

Validate, verify, and enrich Korean Business Registration Numbers (사업자등록번호). Get company region, tax office, industry classification, and corporate registration details — all in English JSON. The only tool of its kind for the global market.

- **URL**: https://apify.com/lazymac/korean-business-data.md
- **Developed by:** [2x lazymac](https://apify.com/lazymac) (community)
- **Categories:** Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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

## Korean Business Data — BRN Validator & Enricher

**The first and only English-language tool for Korean business registration data on the global market.**

Validate, verify, and enrich Korean Business Registration Numbers (사업자등록번호, BRN) with comprehensive company metadata — region, tax office, industry classification, entity type, and corporate registration details — all returned as clean, structured JSON in English.

---

### Why This Tool Exists

Every year, thousands of companies expanding into the Korean market face the same frustrating barrier: **Korean business data is locked behind a language wall.**

- Government registries are entirely in Korean
- No English-language API exists for Korean company verification
- Manual research takes 30+ minutes per company at $25+/company
- Existing tools only work with Korean-language interfaces

**This actor solves that problem completely.** One API call returns verified Korean business data in English JSON — no Korean language skills required.

---

### What You Get

#### For Each Business Registration Number (BRN)

| Field | Description | Example |
|-------|-------------|---------|
| `valid` | Checksum verification result | `true` |
| `formatted` | Standard BRN format | `124-86-62507` |
| `regionCode` | 3-digit tax office region | `124` |
| `region.province` | Province/City (English) | `Seoul` |
| `region.city` | District/Area (English) | `Dongdaemun-gu / Jungnang-gu` |
| `region.taxOffice` | Tax office name (English) | `Dongdaemun Tax Office` |
| `industry.section` | KSIC section code | `M` |
| `industry.name` | Industry name (English) | `Professional, Scientific and Technical Activities` |
| `industry.entityCategory` | Business entity type | `Corporate` |
| `enrichment.entityType` | Detailed entity classification | `Corporate Entity (법인사업자)` |
| `enrichment.taxOfficeTier` | Tax office administrative level | `Seoul Metropolitan` |
| `enrichment.isSeoulBased` | Seoul location flag | `true` |

#### For Corporate Registration Numbers (법인등록번호)

| Field | Description | Example |
|-------|-------------|---------|
| `valid` | Checksum verification | `true` |
| `formatted` | Standard format | `110111-1234567` |
| `registrationOffice` | Court name (English) | `Seoul Central District Court` |
| `serialNumber` | Registration serial | `123456` |

---

### Use Cases

#### 1. Due Diligence & KYC/KYB
Verify Korean business registrations instantly during onboarding. Critical for:
- **FinTech companies** processing Korean merchant applications
- **Banks** performing Know Your Business (KYB) checks
- **Investment firms** doing due diligence on Korean targets

#### 2. B2B Lead Enrichment
Enrich your Korean prospect database with:
- Verified business status and region
- Industry classification for targeting
- Entity type (individual vs corporate)
- Tax office jurisdiction

#### 3. Market Research
Analyze Korean business landscape:
- Map business density by region
- Identify industry distribution patterns
- Segment by entity type (individual/corporate/non-profit)

#### 4. Compliance & Audit
- Bulk-validate Korean vendor BRNs
- Verify business registration authenticity
- Cross-reference corporate registration numbers
- Audit supplier databases

#### 5. Data Pipeline Integration
- Validate Korean BRNs in ETL pipelines
- Enrich CRM records with Korean business metadata
- Automate Korean market data collection

---

### Quick Start

#### Basic Validation (1 minute setup)

```json
{
  "mode": "validate_and_enrich",
  "businessNumbers": ["124-86-62507", "211-87-89871"],
  "outputLanguage": "en"
}
````

#### Batch Processing (500 numbers)

```json
{
  "mode": "batch_validate",
  "businessNumbers": ["1248662507", "2118789871", "1208147521", ...],
  "batchSize": 100,
  "skipInvalid": true,
  "outputFormat": "csv_ready"
}
```

#### Region Analysis

```json
{
  "mode": "region_lookup",
  "businessNumbers": ["124-86-62507"],
  "includeRegionDetails": true,
  "outputLanguage": "both"
}
```

#### Industry Classification

```json
{
  "mode": "industry_classify",
  "businessNumbers": ["124-86-62507"],
  "includeIndustryCode": true
}
```

***

### Output Examples

#### Full Enrichment Output

```json
{
  "input": "124-86-62507",
  "valid": true,
  "formatted": "124-86-62507",
  "regionCode": "124",
  "businessTypeCode": "86",
  "serialNumber": "6250",
  "checkDigit": "7",
  "region": {
    "province": "Seoul",
    "city": "Dongdaemun-gu / Jungnang-gu",
    "taxOffice": "Dongdaemun Tax Office",
    "code": "124"
  },
  "industry": {
    "section": "M",
    "name": "Professional, Scientific and Technical Activities",
    "nameEN": "Professional, Scientific and Technical Activities",
    "nameKO": "전문, 과학 및 기술 서비스업",
    "subtype": "Corporate - professional services",
    "entityCategory": "Corporate",
    "ksicSection": "M"
  },
  "enrichment": {
    "entityType": "Corporate Entity (법인사업자)",
    "entityTypeEN": "Corporate Entity",
    "taxOfficeTier": "Seoul Metropolitan",
    "isSeoulBased": true,
    "isMetropolitan": false,
    "isSpecialEntity": false
  }
}
```

#### Invalid BRN Output

```json
{
  "input": "000-00-00000",
  "valid": false,
  "error": "체크섬이 일치하지 않습니다.",
  "errorEN": "Checksum verification failed. The number may be invalid or contain a typo."
}
```

#### CSV-Ready Output

```json
{
  "input": "124-86-62507",
  "valid": "true",
  "formatted": "124-86-62507",
  "regionCode": "124",
  "businessTypeCode": "86",
  "province": "Seoul",
  "city": "Dongdaemun-gu / Jungnang-gu",
  "taxOffice": "Dongdaemun Tax Office",
  "industrySection": "M",
  "industryName": "Professional, Scientific and Technical Activities"
}
```

***

### Integration Guides

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "mode": "validate_and_enrich",
    "businessNumbers": ["124-86-62507", "211-87-89871"],
    "outputLanguage": "en",
}

run = client.actor("lazymac/korean-business-data").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['formatted']}: {item['region']['province']} - {item['industry']['name']}")
```

#### Node.js

```javascript
const { ApifyClient } = require('apify-client');

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('lazymac/korean-business-data').call({
  mode: 'validate_and_enrich',
  businessNumbers: ['124-86-62507', '211-87-89871'],
  outputLanguage: 'en',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
  console.log(`${item.formatted}: ${item.region.province} - ${item.industry.name}`);
});
```

#### cURL (via Apify API)

```bash
curl -X POST "https://api.apify.com/v2/acts/lazymac~korean-business-data/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "validate_and_enrich",
    "businessNumbers": ["124-86-62507"],
    "outputLanguage": "en"
  }'
```

#### Zapier / Make / n8n

Use the Apify integration in your workflow automation tool:

1. Add an "Apify" action step
2. Select actor: `lazymac/korean-business-data`
3. Configure input with your BRN list
4. Map output fields to your next step

***

### Korean BRN Structure Explained

A Korean Business Registration Number (사업자등록번호) is a **10-digit number** assigned by the National Tax Service (국세청):

```
XXX - XX - XXXXX
 │     │     │
 │     │     └── Serial number (4 digits) + Check digit (1 digit)
 │     └── Business type code (01-99)
 └── Tax office region code (101-999)
```

#### Region Codes

| Range | Region |
|-------|--------|
| 101-189 | Seoul Metropolitan |
| 201-289 | Metropolitan Cities (Busan, Daegu, Incheon, Gwangju, Daejeon, Ulsan, Sejong) |
| 301-399 | Gyeonggi Province |
| 401-449 | Gangwon Province |
| 451-499 | Chungcheongbuk Province |
| 601-659 | Chungcheongnam Province |
| 660-699 | Jeollabuk Province |
| 700-739 | Jeollanam Province |
| 740-799 | Gyeongsangbuk Province |
| 801-859 | Gyeongsangnam Province |
| 860-869 | Jeju Province |
| 901-999 | Special (Corporate/Foreign entities) |

#### Business Type Codes

| Range | Entity Type |
|-------|-------------|
| 01-79 | Individual Business (개인사업자) |
| 80 | Non-Profit Organization (비영리법인) |
| 81-99 | Corporate Entity (법인사업자) |

#### Checksum Algorithm

The 10th digit is a **checksum** calculated using weights `[1, 3, 7, 1, 3, 7, 1, 3, 5]`:

```
Sum = Σ(digit[i] × weight[i]) for i = 0..8
Sum += floor(digit[8] × 5 / 10)
Check digit = (10 - (Sum mod 10)) mod 10
```

This actor performs this validation automatically for every number submitted.

***

### FAQ

#### Q: Can this verify if a Korean business is currently active?

**A:** This actor validates the mathematical structure and provides region/industry metadata. To check real-time active/inactive status, you would need to integrate with the Korean NTS (국세청) API, which requires a separate Korean government API key. We plan to add this feature in a future update.

#### Q: What BRN formats are accepted?

**A:** Both hyphenated (`124-86-62507`) and plain digit (`1248662507`) formats are accepted. The actor normalizes all inputs automatically.

#### Q: How many BRNs can I process at once?

**A:** Up to 500 BRNs per run. For larger volumes, you can chain multiple runs using the Apify API.

#### Q: Is this data from official Korean government sources?

**A:** The validation algorithm and region code mappings are based on the official Korean National Tax Service (국세청) specification. Industry classifications follow the Korean Standard Industrial Classification (KSIC Rev.10).

#### Q: Does this work with corporate registration numbers too?

**A:** Yes! You can validate both Business Registration Numbers (사업자등록번호, 10 digits) and Corporate Registration Numbers (법인등록번호, 13 digits) in the same run.

#### Q: What language options are available?

**A:** Output is available in English only, Korean only, or bilingual (both). All region names, tax offices, and industry classifications have full English translations.

#### Q: Can I export results as CSV?

**A:** Yes! Set `outputFormat` to `"csv_ready"` for flat key-value pairs that export cleanly to CSV/Excel.

#### Q: Is there a free trial?

**A:** Apify provides free platform credits for new users. You can test this actor with your own BRNs using your free credits.

#### Q: How is pricing calculated?

**A:** Pay-per-event (PPE): you're charged per valid BRN processed. Invalid BRNs are not charged. Check Apify's platform pricing for the exact per-event cost.

#### Q: Can I use this in my SaaS product?

**A:** Yes! The Apify API allows full programmatic access. Use the Python, Node.js, or REST API integration to embed Korean BRN validation directly in your product.

***

### Cost Estimation

| Volume | Estimated Cost | Time |
|--------|---------------|------|
| 10 BRNs | ~$0.01 | < 1 sec |
| 100 BRNs | ~$0.05 | < 2 sec |
| 1,000 BRNs | ~$0.50 | < 10 sec |
| 10,000 BRNs | ~$5.00 | < 60 sec |

*Costs are estimates based on Apify platform compute + PPE charges. Actual costs may vary.*

***

### Comparison: Korean Business Data Actor vs Alternatives

| Feature | This Actor | Manual Research | Korean Gov Portal | Other Tools |
|---------|-----------|----------------|-------------------|-------------|
| Language | English | Korean only | Korean only | Korean only |
| Speed | < 1 sec/BRN | 30+ min/company | 5 min/lookup | Varies |
| Cost | ~$0.001/BRN | $25+/company | Free (but manual) | N/A |
| Batch processing | ✅ 500/run | ❌ | ❌ (one at a time) | Limited |
| API access | ✅ REST + Python + Node | ❌ | Limited | Varies |
| Region details | ✅ English | ❌ | ✅ Korean only | ❌ |
| Industry classification | ✅ KSIC | ❌ | ❌ | ❌ |
| Corporate number validation | ✅ | ❌ | ✅ Korean only | ❌ |

***

### Changelog

#### v1.0.0 (2026-04-17)

- Initial release
- BRN validation with checksum verification
- Corporate registration number validation
- English region name translation (all 60+ tax office jurisdictions)
- KSIC industry classification (21 sections)
- Entity type detection (individual/corporate/non-profit)
- Batch processing up to 500 numbers
- 3 output formats (detailed, summary, CSV-ready)
- Bilingual support (English/Korean/both)
- PPE monetization

#### Roadmap

- v1.1: Real-time business status check (NTS API integration)
- v1.2: DART corporate filing data
- v1.3: Business address geocoding
- v1.4: Historical registration data

***

### About

Built by [lazymac](https://apify.com/lazymac) — specializing in Korean data tools for the global market.

- **GitHub:** [lazymac2x](https://github.com/lazymac2x)
- **Other actors:** [Apify Store](https://apify.com/lazymac)

**Have a custom Korean data need?** Contact us for custom actor development.

***

*Keywords: Korean business data, BRN validation, 사업자등록번호, Korean company verification, KYB Korea, Korean tax office, KSIC classification, Korean corporate data API, Korea market research, Korean business registry*

# Actor input Schema

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

Choose the operation to perform on the business numbers.

## `businessNumbers` (type: `array`):

List of Korean Business Registration Numbers (사업자등록번호). Accepts 10-digit numbers with or without hyphens. Example: \['123-45-67890', '1234567890']

## `corpNumbers` (type: `array`):

List of Korean Corporate Registration Numbers (법인등록번호, 13 digits). Used for additional corporate entity verification.

## `outputLanguage` (type: `string`):

Language for region names, office names, and descriptions in the output.

## `includeIndustryCode` (type: `boolean`):

When enabled, maps the business type code to the Korean Standard Industrial Classification (KSIC Rev.10) category.

## `includeRegionDetails` (type: `boolean`):

When enabled, returns detailed information about the tax office region including province, city, and district.

## `includeCorporateInfo` (type: `boolean`):

When enabled and corporate registration numbers are provided, returns registration court and entity type information.

## `outputFormat` (type: `string`):

Choose how results are structured in the output dataset.

## `batchSize` (type: `integer`):

Number of BRNs to process in each batch. Higher values = faster but more memory. Range: 1-500.

## `skipInvalid` (type: `boolean`):

When enabled, invalid BRNs are silently skipped. When disabled, invalid BRNs are included in output with error details.

## `deduplicateInput` (type: `boolean`):

Remove duplicate business numbers before processing.

## Actor input object example

```json
{
  "mode": "validate_and_enrich",
  "businessNumbers": [
    "120-81-47521",
    "124-86-62500",
    "211-82-12344"
  ],
  "corpNumbers": [],
  "outputLanguage": "en",
  "includeIndustryCode": true,
  "includeRegionDetails": true,
  "includeCorporateInfo": true,
  "outputFormat": "detailed",
  "batchSize": 50,
  "skipInvalid": false,
  "deduplicateInput": true
}
```

# 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 = {
    "mode": "validate_and_enrich",
    "businessNumbers": [
        "120-81-47521",
        "124-86-62500",
        "211-82-12344"
    ],
    "outputLanguage": "en"
};

// Run the Actor and wait for it to finish
const run = await client.actor("lazymac/korean-business-data").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 = {
    "mode": "validate_and_enrich",
    "businessNumbers": [
        "120-81-47521",
        "124-86-62500",
        "211-82-12344",
    ],
    "outputLanguage": "en",
}

# Run the Actor and wait for it to finish
run = client.actor("lazymac/korean-business-data").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 '{
  "mode": "validate_and_enrich",
  "businessNumbers": [
    "120-81-47521",
    "124-86-62500",
    "211-82-12344"
  ],
  "outputLanguage": "en"
}' |
apify call lazymac/korean-business-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lazymac/korean-business-data",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Korean Business Data — BRN Validator & Enricher",
        "description": "Validate, verify, and enrich Korean Business Registration Numbers (사업자등록번호). Get company region, tax office, industry classification, and corporate registration details — all in English JSON. The only tool of its kind for the global market.",
        "version": "1.0",
        "x-build-id": "yMrgJ6s2qfu5h5jKu"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lazymac~korean-business-data/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lazymac-korean-business-data",
                "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/lazymac~korean-business-data/runs": {
            "post": {
                "operationId": "runs-sync-lazymac-korean-business-data",
                "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/lazymac~korean-business-data/run-sync": {
            "post": {
                "operationId": "run-sync-lazymac-korean-business-data",
                "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": [
                    "businessNumbers"
                ],
                "properties": {
                    "mode": {
                        "title": "Operation Mode",
                        "enum": [
                            "validate_and_enrich",
                            "batch_validate",
                            "region_lookup",
                            "industry_classify"
                        ],
                        "type": "string",
                        "description": "Choose the operation to perform on the business numbers.",
                        "default": "validate_and_enrich"
                    },
                    "businessNumbers": {
                        "title": "Business Registration Numbers (BRN)",
                        "type": "array",
                        "description": "List of Korean Business Registration Numbers (사업자등록번호). Accepts 10-digit numbers with or without hyphens. Example: ['123-45-67890', '1234567890']",
                        "default": []
                    },
                    "corpNumbers": {
                        "title": "Corporate Registration Numbers (Optional)",
                        "type": "array",
                        "description": "List of Korean Corporate Registration Numbers (법인등록번호, 13 digits). Used for additional corporate entity verification.",
                        "default": []
                    },
                    "outputLanguage": {
                        "title": "Output Language",
                        "enum": [
                            "en",
                            "ko",
                            "both"
                        ],
                        "type": "string",
                        "description": "Language for region names, office names, and descriptions in the output.",
                        "default": "en"
                    },
                    "includeIndustryCode": {
                        "title": "Include KSIC Industry Classification",
                        "type": "boolean",
                        "description": "When enabled, maps the business type code to the Korean Standard Industrial Classification (KSIC Rev.10) category.",
                        "default": true
                    },
                    "includeRegionDetails": {
                        "title": "Include Detailed Region Info",
                        "type": "boolean",
                        "description": "When enabled, returns detailed information about the tax office region including province, city, and district.",
                        "default": true
                    },
                    "includeCorporateInfo": {
                        "title": "Include Corporate Registration Info",
                        "type": "boolean",
                        "description": "When enabled and corporate registration numbers are provided, returns registration court and entity type information.",
                        "default": true
                    },
                    "outputFormat": {
                        "title": "Output Format",
                        "enum": [
                            "detailed",
                            "summary",
                            "csv_ready"
                        ],
                        "type": "string",
                        "description": "Choose how results are structured in the output dataset.",
                        "default": "detailed"
                    },
                    "batchSize": {
                        "title": "Processing Batch Size",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Number of BRNs to process in each batch. Higher values = faster but more memory. Range: 1-500.",
                        "default": 50
                    },
                    "skipInvalid": {
                        "title": "Skip Invalid Numbers",
                        "type": "boolean",
                        "description": "When enabled, invalid BRNs are silently skipped. When disabled, invalid BRNs are included in output with error details.",
                        "default": false
                    },
                    "deduplicateInput": {
                        "title": "Deduplicate Input",
                        "type": "boolean",
                        "description": "Remove duplicate business numbers before processing.",
                        "default": true
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
