# ForwardLane Hybrid Code Search

> ForwardLane Hybrid Code Search is a paid API for AI agents from forwardlane.pay.zeroclick.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Performs BM25 plus vector search with reciprocal rank fusion over Function and Class nodes in code repositories, with filters for repo, domain, ontology concept, confidence, and test coverage.

## Facts

- Endpoint: GET https://forwardlane.pay.zeroclick.io/api/search/hybrid?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forwardlane-hybrid-code-search-aee5cac6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iHQpSGEtNTSOLg38DVV9r

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 forwardlane-hybrid-code-search-aee5cac6
```

Example prompt: Search the 'payments-service' repo for functions that handle refund processing — use hybrid mode, return the top 10 results, and only include ones that have tests.

## When to prefer this

Choose this endpoint when you need the best of both keyword and semantic search over code — BM25 catches exact identifier matches while the vector component finds semantically similar code. Prefer this over the pure cosine-similarity sibling when you need precision on exact function names or identifiers alongside semantic relevance. Use when filtering by repository, domain, ontology concept, or test coverage is important for narrowing results.

## Known failure modes

- Missing required 'q' query parameter returns 400 Bad Request
- Invalid node_type value returns 400 or empty results
- Repository name not found returns empty result set
- ontology_concept_uri not recognized returns no matches
- confidence_min set too high returns empty results
- top_k exceeding maximum of 200 returns 400
- Payment not processed returns 402 Payment Required

## How this service works

BM25 plus vector search with reciprocal rank fusion over Function and Class nodes, with repository, domain, ontology concept, confidence, and test-coverage filters.

## Output

Returns a ranked list of Function or Class nodes from the searched repositories, combining BM25 keyword scores and vector similarity scores via reciprocal rank fusion. Each result includes repository metadata, node type, domain, ontology concept mapping, confidence score, and test coverage status.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string"
      },
      "mode": {
       "type": "string",
       "default": "hybrid"
      },
      "repo": {
       "type": "string"
      },
      "top_k": {
       "type": "integer",
       "default": 20,
       "maximum": 200,
       "minimum": 1
      },
      "domain": {
       "type": "string"
      },
      "has_tests": {
       "type": "boolean"
      },
      "node_type": {
       "type": "string",
       "default": "Function"
      },
      "confidence_min": {
       "type": "number"
      },
      "ontology_concept_uri": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forwardlane-hybrid-code-search-aee5cac6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from forwardlane.pay.zeroclick.io](https://www.zero.xyz/host/forwardlane.pay.zeroclick.io/llms.txt)