# ForwardLane Hybrid Code Search

> ForwardLane Hybrid Code Search is a paid API for AI agents from agents.forwardlane.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-19).

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

## Facts

- Endpoint: GET https://agents.forwardlane.com/api/search/hybrid
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forwardlane-hybrid-code-search-b5b5dd81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Ch03tRgslEthH6LBHs2A

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-b5b5dd81
```

Example prompt: Search my codebase for functions related to 'user authentication' using hybrid mode, filtering to the 'auth-service' repo with a confidence of at least 0.8 and only include nodes that have tests — give me the top 10 results.

## When to prefer this

Choose this endpoint when you need the best of both keyword and semantic code search — it combines BM25 lexical matching with vector similarity and fuses rankings, outperforming either alone. Prefer it over the pure vector search sibling when exact identifiers or method names matter alongside conceptual similarity. Use when you need fine-grained filters like confidence thresholds, test coverage, ontology concept alignment, or repository scoping.

## Known failure modes

- Missing required query parameter 'q' returns a 400 validation error
- Invalid node_type value returns a schema validation error
- Unknown repository name in 'repo' filter returns empty results
- ontology_concept_uri that doesn't match any indexed concept returns empty list
- top_k out of range (below 1 or above 200) returns a 422 error
- Payment of 0.05 USDC not completed 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 code nodes with associated metadata including repository, confidence scores, ontology concept links, test coverage status, and relevance rankings derived from reciprocal rank fusion of BM25 and vector similarity scores.

## 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-b5b5dd81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.forwardlane.com](https://www.zero.xyz/host/agents.forwardlane.com/llms.txt)