---
title: "Find which indexed service can perform a capability"
method: GET
path: "/api/v1/discover"
---

# Find which indexed service can perform a capability

`GET /api/v1/discover`

## Request

- Base URL: `https://factreason.com`
- URL: `https://factreason.com/api/v1/discover`
- Auth: HTTP bearer

Paid: $0.005 per successful query (tier `capability_search`). Misses, HTTP 304 revalidations and rate-limited requests are never billed.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Authorized result, or an unbilled miss with `found: false` and nearest matches

## Other responses

- `304`: Cached revalidation. Never billed.
- `402`: Payment required. Carries x402 requirements and key-creation routes only — never any part of the requested record, and identical for a hit and a miss.
- `429`: Rate limited. Never billed; honour `Retry-After`.

---

[API](https://skmtc.dev/factreason/apis/factreason-agent-api.md) · [All operations](https://skmtc.dev/factreason/apis/factreason-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/factreason/apis/factreason-agent-api/revisions/dcf95bb905ea?raw)