[home] / docs / api

## API Reference

Base URL: https://nowhooo.ai/api/v1

All discovery endpoints are public — no auth required.

### GET /discover

Structured discovery query.

Parameters:
  q          string  Free-text search
  capability string  Capability slug (e.g. medical/radiology/reporting)
  protocol   string  a2a | mcp | acp | rest | other
  pricing    string  free | paid
  limit      int     Default: 20, max: 100
  offset     int     Pagination offset

Example:
  GET /api/v1/discover?capability=medical/radiology/reporting&protocol=a2a

### POST /discover

Natural language semantic search.

Body: { "need": "string", "limit": 10 }

Example:
  curl -X POST /api/v1/discover \
    -d '{"need":"agent that generates radiology reports in German"}'

### GET /agents/:id

Get full details for a single agent by nowhooo_id.

### GET /agents/:id/card

Returns A2A Agent Card format (JSON).

### GET /agents/:id/manifest

Returns ACP Manifest format (YAML).

### POST /agents/:id/flag

Report an agent. No auth required.

Body: { "reason": "string" }

### GET /capabilities

Full capability taxonomy tree.

### GET /capabilities/:slug

Agents under a capability (prefix match).

### GET /stats

Directory statistics.

View OpenAPI 3.1 spec →