# CSV Filter Rows

> CSV Filter Rows is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Filters CSV rows in-memory, keeping only rows where a specified column's value matches one of a caller-supplied allowlist of values, returning counts and normalized results as versioned deterministic JSON.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/csv-filter-rows
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/csv-filter-rows-6cb5c757
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qPsRdmFTY0LaUNkgXMpue

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 csv-filter-rows-6cb5c757 -d '<json body>'
```

Example prompt: Filter this CSV so we only keep rows where the 'status' column equals 'active' or 'pending' — here's the full CSV text.

## When to prefer this

Use this endpoint when an agent needs to deterministically subset a CSV dataset to rows matching an exact column-value allowlist before handing structured data to a downstream tool with a strict input contract. Prefer this over general-purpose code execution when you need a lightweight, in-memory, no-retention, versioned result that's safe to call in a pipeline without side effects.

## Known failure modes

- Column name not found in CSV header — returns validation error indicating missing column
- CSV text malformed or unparseable — returns parse error with description
- Allowed values array empty — may return zero rows or an error indicating no filter criteria
- Input CSV exceeds 8192-character limit — request rejected with size error
- More than 256 allowed values provided — request rejected with array length error

## How this service works

CSV Filter Rows: CSV Filter Rows keeps CSV rows whose column equals one of caller values from bounded caller-supplied values without an external provider. Call CSV Filter Rows before an agent hands structured data or a batch plan to a downstream tool with a stricter contract. Returns the bounded transformation or validation finding with counts, normalized values, and a versioned result contract for CSV Filter Rows as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-party…

## Output

A versioned deterministic JSON object containing the filtered CSV rows (only those where the specified column matched one of the allowed values), row counts (total input rows, matching rows, excluded rows), normalized column values, and a versioned result contract identifier.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "maxLength": 8192,
   "description": "Text supplied to CSV Filter Rows; used only for this bounded calculation and processed in memory without retention."
  },
  "column": {
   "type": "string",
   "maxLength": 8192,
   "description": "Column supplied to CSV Filter Rows; used only for this bounded calculation and processed in memory without retention."
  },
  "allowed": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 8192
   },
   "maxItems": 256,
   "description": "Allowed supplied to CSV Filter Rows; used only for this bounded calculation and processed in memory without retention."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "csv": "id,status\n1,ok",
   "row_count": 1
  },
  "schema": "delx/util-csv-filter-rows/v1",
  "status": "pass",
  "evidence": {
   "retained": false,
   "input_sha256": "07a9a4966734b751aa1a99dbb6de90bbea45144ddd02a441e568987a6e041371",
   "external_calls": 0
  },
  "operation": "data_batch:csv_filter_rows"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/csv-filter-rows-6cb5c757/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)