# ParquetHarmonize

> ParquetHarmonize is a paid API for AI agents from mainnet-c1b2ed1---parquetharmonize-v01-x402-h2k3kompva-pd.a.run.app, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Merges 2–8 Parquet files into a unified, compatible schema and returns the harmonized Parquet output along with validation metadata.

## Facts

- Endpoint: POST https://mainnet-c1b2ed1---parquetharmonize-v01-x402-h2k3kompva-pd.a.run.app/v1/harmonize
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/parquetharmonize-e7de305e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W8NYZIIivu0_iVJk-aNp4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability parquetharmonize-e7de305e -d '<json body>'
```

Example prompt: I have 3 Parquet files exported from different data sources that have slightly different schemas — can you harmonize them into a single compatible Parquet file and show me any validation issues?

## When to prefer this

Use this endpoint when you need to programmatically merge 2–8 Parquet files that may have divergent schemas (different column names, types, or nullability) and require a single harmonized output. Prefer it over manual schema reconciliation scripts when you also need validation metadata confirming what was changed. Best suited for ETL pipelines, data lake ingestion workflows, and cross-team data consolidation tasks where schema drift is common.

## Known failure modes

- Fewer than 2 or more than 8 files provided — returns validation error
- Total input exceeds 20 MiB — returns payload too large error
- A single file exceeds 12 MiB — returns per-file size limit error
- Irreconcilable type conflicts (e.g. string vs nested struct on same column) — returns schema incompatibility error
- Malformed or corrupted Parquet binary — returns parse error
- Payment not provided or insufficient — returns 402 Payment Required

## How this service works

Harmonize 2 to 8 Parquet files into a compatible schema and return the harmonized Parquet payload with validation metadata.

## Output

A harmonized Parquet binary payload representing all input files merged into a single compatible schema, accompanied by validation metadata describing any schema conflicts detected and how they were resolved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "files": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "binary"
   },
   "maxItems": 8,
   "minItems": 2,
   "description": "2 to 8 Parquet files. Maximum 12 MiB per file and 20 MiB total input."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/parquetharmonize-e7de305e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mainnet-c1b2ed1---parquetharmonize-v01-x402-h2k3kompva-pd.a.run.app](https://www.zero.xyz/host/mainnet-c1b2ed1---parquetharmonize-v01-x402-h2k3kompva-pd.a.run.app/llms.txt)