> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search

> Find the best executable capability for an intent.

`POST /api/v2/search` covers the entire public discovery surface:

```json theme={null}
{ "query": "OCR for handwriting", "limit": 10 }
```

```json theme={null}
{ "aiId": "ai_123" }
```

```json theme={null}
{ "query": "extract tables", "aiId": "ai_123" }
```

```json theme={null}
{ "capabilityId": "cap_456" }
```

Every result includes the exact `aiId`, `capabilityId`, and `capabilityRevision` needed by Act. Result order is canonical; Darwin does not expose a synthetic confidence score. Pagination uses `nextCursor`, not a separate count endpoint.

When a reviewed capability needs a customer account or payment, Search also returns safe `accountRequirement` and `paymentRequirement` projections. These describe the verified provider, readable access purpose, retention choices, and supported payment handlers. Search never returns authorization URLs, OAuth client identifiers, credentials, raw private scopes, or unverified registry claims.

Search returns public information and never authorizes spending or execution.