{"uid":"cap_r_3jhiflb2CZjjWvsgjdb","slug":"pipe0-withzero-xyz-pipe0-search-run-status-check-6b03df31","name":"Pipe0 Search Run Status Check","description":"Check a Pipe0 search run by id. Proof route; no Zero charge.","url":"https://pipe0.withzero.xyz/api/v1/search/check","method":"POST","headers":{},"bodySchema":{"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},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["data"],"properties":{"data":{"description":"Raw JSON response returned by Pipe0."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_cNP6Lt7qETcoWFp2T9YHB","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"pipe0.search_check:3"}],"brandName":"pipe0.withzero.xyz","brandSlug":"pipe0-withzero-xyz-mpp","brandBaseUrl":"https://pipe0.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Checks the status and result of a previously submitted async Pipe0 search run by its run ID, at no charge.","exampleAgentPrompt":"Can you check the status of my Pipe0 search run with ID 'abc123xyz' and tell me if the results are ready?","exampleUseCases":[{"title":"Monitor background search task progress","prompt":"I submitted a Pipe0 search a few minutes ago and got back run ID 'run_5f7k9m2p'. Can you check if that search has finished yet and tell me what it found?"},{"title":"Retrieve completed async search results","prompt":"I need to get the results from a Pipe0 search I started earlier—the run ID was 'search_20240115_abc'. Can you pull those results for me?"},{"title":"Poll for in-progress search completion","prompt":"Check on my Pipe0 search job 'run_xyz789' and let me know if it's done processing. If the results are ready, show me what came back."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":"# Check search run — state read for the search workflow\n\nFree. Reads a Pipe0 search run by `run_id`, returning raw status/results in `data`. The paid POST /api/v1/search/run/sync returns results inline, so a sync run needs no check; use this to poll an async search started elsewhere.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:26.726Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:21.791Z","isFirstParty":true}