MARS documentation
HTTP guides

Discovery endpoints

Structured, MARS-QL, and bounded federated discovery.

Local discovery

Structured discovery accepts a canonical entryType, AND-combined conditions, bounded limit, and optional cursor. MARS-QL discovery accepts a query string. Both return complete records.

Federated discovery

Client federated discovery requires an authenticated principal with federated_discovery. The separate signed peer discovery route verifies a federation envelope. Do not confuse the two authentication modes.

Result completeness

Inspect federation metadata for partial or failed peers. An individual page is bounded; follow valid query-bound cursors to continue. A discovery result is not a verification endorsement.

Source authority

This page describes the checked-in implementation, not the availability of a public registry.

  • mars-server/src/api/mod.rs
  • mars-server/src/contracts.rs
  • docs/api/openapi.v1.json

On this page