# Developers: Dike API Reference & Studio

REST and gRPC reference and interactive studio for the Dike API: hybrid search, grounded reasoning, citation resolution, and legal-graph traversal.

## API Surface

Base path `/v1`, `Authorization: Bearer <api_key>` on all `/v1/*` routes.

- `POST /v1/search` — hybrid semantic + lexical retrieval over the indexed MENA legal corpus, with optional cross-encoder rerank.
- `POST /v1/reason` — grounded Q&A with a hallucination guard: citations must resolve to the retrieved document set or get stripped, never fabricated. Streaming supported.
- `POST /v1/cite` — parse and resolve an Arabic citation string against the indexed corpus.
- `GET /v1/document/{canonical_id}` — fetch a single indexed document by its canonical ID.
- `POST /v1/graph/traverse` — BFS traversal over the citation graph (cites/amends/repeals/implements/interprets relationships).
- `GET /v1/jurisdictions` — list currently indexed jurisdictions and their coverage.

A gRPC mirror of search/reason is available on a separate port for tool-use loops that prefer gRPC over HTTP.

## Getting Access

API keys are currently gated behind a waitlist. Join it at [dike.it.com/developers](https://dike.it.com/developers/), or use the "Schedule a Conversation" option to talk to the team directly.

## More

- [About & Manifesto](https://dike.it.com/about/)
- [Coverage / Index Map](https://dike.it.com/coverage/)
- [Open Models](https://dike.it.com/models/)
