# Pipe0 Search Run Status Check

> Pipe0 Search Run Status Check is a paid API for AI agents from pipe0.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-15).

Checks the status and result of a previously submitted async Pipe0 search run by its run ID, at no charge.

## Facts

- Endpoint: POST https://pipe0.withzero.xyz/api/v1/search/check
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 3
- Provider: pipe0.withzero.xyz
- Website: https://pipe0.withzero.xyz
- Canonical page: https://www.zero.xyz/c/pipe0-withzero-xyz-pipe0-search-run-status-check-6b03df31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r_3jhiflb2CZjjWvsgjdb

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 pipe0-withzero-xyz-pipe0-search-run-status-check-6b03df31 -d '<json body>'
```

Example prompt: Can you check the status of my Pipe0 search run with ID 'abc123xyz' and tell me if the results are ready?

## When to prefer this

Use this endpoint after calling the Pipe0 async search workflow route (the singular search pass-through) to poll for and retrieve the completed result. This is the correct polling endpoint specifically for search runs, as opposed to the separate pipes run check endpoint used for non-search Pipe0 workflows. It is free of charge and has no side effects.

## Known failure modes

- run_id not found or invalid returns an error response
- run still in progress returns a pending/incomplete status rather than final data
- malformed or missing run_id returns a 400-level validation error
- Pipe0 backend unavailable causes a 5xx error

## How this service works

Check a Pipe0 search run by id. Proof route; no Zero charge.

## Output

Returns a JSON object containing a 'data' field with the raw Pipe0 response for the given search run, including the current status or completed result payload of the async search task.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "run_id"
 ],
 "properties": {
  "run_id": {
   "type": "string",
   "minLength": 1,
   "description": "Pipe0 run/task id returned by an async run route."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "description": "Raw JSON response returned by Pipe0."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pipe0-withzero-xyz-pipe0-search-run-status-check-6b03df31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pipe0.withzero.xyz](https://www.zero.xyz/host/pipe0.withzero.xyz/llms.txt)
