# CSV Header Reader

> CSV Header Reader 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-13).

Parses the first row of a UTF-8 CSV string and returns the column header names as a list

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/csv-headers
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/csv-header-reader-cdd1827c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PKK-xOXNAYAv8Imtp0VnF

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-header-reader-cdd1827c -d '<json body>'
```

Example prompt: I have a CSV file — can you pull out the header row for me so I know what columns are in it before I start mapping fields? Here's the content: 'name,email,age,signup_date\nAlice,alice@example.com,30,2024-01-01'

## When to prefer this

Choose this endpoint when you need a lightweight, deterministic way to introspect CSV column names before an import, transformation, or mapping step — especially in agentic pipelines where you want to avoid paying for a full parse. Ideal when you don't have a local CSV parser available, need a consistent JSON list output, and want a no-subscription micro-cost utility with no API key setup. Prefer this over full CSV parsing services when you only need the header row.

## Known failure modes

- Empty or blank csv_text input causing a validation error (not billed)
- CSV with no newline — treated as a single-row file, all text returned as one header
- Malformed UTF-8 encoding causing a parse error
- Missing csv_text field in request body returning a structured validation error
- Payment failure or insufficient USDC balance blocking the call

## How this service works

CSV header row. Use to map columns before import or transformation steps. Returns the first-row headers as a list. $0.001 USDC per successful call via x402 on Base—deterministic first-party JSON, no API key, no subscription, and nothing is billed on structured validation errors.

## Output

A JSON list of header strings extracted from the first row of the provided CSV text, e.g. ["name", "email", "age"]. Returns deterministic first-party output with no third-party data upload. Structured validation errors are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv_text": {
   "type": "string",
   "description": "UTF-8 CSV text. Parsed locally; not uploaded to third parties."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "schema": "delx/csv-headers/v1",
  "headers": [
   "name",
   "score"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/csv-header-reader-cdd1827c/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)