# 402utils.com jq Filter

> 402utils.com jq Filter is a paid API for AI agents from 402utils.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Applies a jq-style filter to a JSON document and returns the full output stream as a results array

## Facts

- Endpoint: POST https://402utils.com/v1/jq
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/402utils-com-jq-filter-acf5c947
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kGpM8x4vLzAxHo1K_6mix

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 402utils-com-jq-filter-acf5c947 -d '<json body>'
```

Example prompt: Run this jq filter '.users | map(.name)' on the following JSON and give me the results: {"users":[{"name":"Alice","age":30},{"name":"Bob","age":25}]}.

## When to prefer this

Use this endpoint when you need to run jq-style queries or transformations on JSON data without installing jq locally or executing untrusted code. Ideal for AI agents that need to reshape, filter, or extract data from JSON documents on the fly. Prefer over regex or manual parsing when the transformation logic is naturally expressible as a jq pipeline. Note: does not support full jq (no variables, def, reduce, regex, or assignment operators).

## Known failure modes

- Invalid jq filter syntax returns an error message
- Filter uses unsupported jq features (variables, def, reduce, regex, assignment) and is rejected
- Filter string exceeds 8192 character limit
- Input JSON is malformed and cannot be parsed
- Filter produces no output for the given input, returning an empty results array
- Payment not received or insufficient USDC balance causes 402 Payment Required response

## How this service works

Apply a jq-style filter to JSON — the JSON swiss-army knife. Supports identity, fields, index/slice/iterate, pipe |, comma, //, and/or/not, arithmetic, comparisons, array/object construction and builtins (select, map, keys, length, add, sort_by, group_by, unique, to_entries, has, range…). A SAFE pure-JS subset (no eval, bounded): no variables, def, reduce, regex or assignment. Returns the whole jq output stream as results[].

## Output

A JSON object with a 'results' array containing all values emitted by the jq filter applied to the input document. Each element in results corresponds to one output value from the jq output stream.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "json": {
   "description": "The input document — any JSON value (object, array, string, number, boolean or null)."
  },
  "filter": {
   "type": "string",
   "description": "A jq-style filter, e.g. '.users | map(.name)'. Max 8192 chars."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/402utils-com-jq-filter-acf5c947/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402utils.com](https://www.zero.xyz/host/402utils.com/llms.txt)