{"uid":"cap_GzIZE7SLI_pg5WNcI_HMC","slug":"forgemesh-x402-service-registry-search-4a0a2752","name":"ForgeMesh x402 Service Registry Search","description":"Search x402 service registry — broad q search plus health, score, category, tag, and tags filters","url":"https://router.forgemesh.io/api/services","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Broad text search across service name, URL, description, category, tags, and x402 metadata."},"tag":{"type":"string","description":"Exact normalized tag match."},"sort":{"enum":["reputation"],"type":"string"},"tags":{"type":"string","description":"Comma-separated tags; all tags must match."},"limit":{"type":"integer","default":100,"maximum":500,"minimum":1},"category":{"type":"string","description":"Broad category bucket such as travel, weather, crypto, finance, automation, data, search, security, geo, or news."},"min_score":{"type":"number","maximum":100,"minimum":0},"health_status":{"enum":["x402","reachable","unreachable","unknown"],"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"category":{"type":["string","null"]},"description":{"type":["string","null"]},"health_status":{"enum":["x402","reachable","unreachable","unknown"],"type":"string"},"reputation_score":{"type":"number"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LwpvuCDdwJUSB48FRm8QS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the ForgeMesh x402 service registry by keyword, category, tag, health status, and reputation score to discover API services","exampleAgentPrompt":"Search the ForgeMesh x402 service registry for crypto finance APIs that are healthy and have a reputation score above 50, and show me up to 20 results.","exampleUseCases":[{"title":"Find healthy weather data APIs","prompt":"Search ForgeMesh for weather-related x402 services that are currently reachable and have good reputation scores, limiting results to 10."},{"title":"Discover high-reputation finance services","prompt":"Look up all finance category APIs in the x402 registry with reputation scores above 75, and show me the top 15 options."},{"title":"Search for reliable travel APIs","prompt":"Find travel-related x402 services on ForgeMesh that are healthy and tagged with geolocation, give me whatever comes back."}],"resultDescription":"Returns a JSON array of matching service records, each containing the service ID, URL, name, description, category, tags, health status (x402/reachable/unreachable/unknown), and numeric reputation score. Results can be sorted by reputation and are limited to a caller-specified count (default 100, max 500).","failureModes":["No results returned when query terms are too specific or no services match the filters","Invalid enum value for health_status or sort fields returns a validation error","min_score outside 0–100 range returns a validation error","limit outside 1–500 range returns a validation error","Registry may be incomplete if services haven't been crawled or indexed yet","Payment of 0.001 USDC not completed results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover available x402-compatible API services in the ForgeMesh registry, especially when filtering by domain category, tag, health status, or reputation score. Prefer this over manual URL guessing or general web search when the goal is to find machine-payable APIs that support the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:37.014Z","isFirstParty":false}