# Waypoint Reference

> Schemas, query recipes, and deterministic fixtures for a fictional relay API.

Version: 2026.10.3. All stations, transfers, and events are synthetic examples. Resource documents are complete, read-only fixtures; there is no live transfer service. Cite the resource title, version, and URL.

## Docs
- [Your first resource query](https://waypointreference.com/resources/docs/quickstart.md?src=llms): Fetch a fixture, filter available stations, and check the result against a known answer.
- [API conventions](https://waypointreference.com/resources/docs/waypoint-api.md?src=llms): Resource envelopes, identifiers, field types, versioning, and the read-only REST and MCP surfaces.
- [Query recipes](https://waypointreference.com/resources/docs/querying-fixtures.md?src=llms): Join station names to transfers, aggregate capacity, and avoid double-counting lifecycle events.
- [Schemas and validation](https://waypointreference.com/resources/docs/schemas.md?src=llms): Validate primitive types, enums, timestamps, and relationships with explicit positive and negative examples.
- [Lifecycle and ordering](https://waypointreference.com/resources/docs/relay-lifecycle.md?src=llms): Reconstruct queued, in-transit, and delivered states from ordered events without assuming arrival order.
- [HTTP status codes](https://waypointreference.com/resources/docs/http-status-codes.md?src=llms): A selected guide to response classes, common codes, redirects, retries, and the headers that change what a client should do.
- [HTTP headers](https://waypointreference.com/resources/docs/http-headers.md?src=llms): A selected guide to request and response fields that describe content, caching, authentication, redirects, and retries.
- [Assistant API](https://waypointreference.com/resources/docs/assistant-api.md?src=llms): Ask the scripted resource assistant about schemas and examples through a token-scoped JSON conversation.

## API
- [OpenAPI description](https://waypointreference.com/openapi.json?src=llms): Existing stateless REST catalog, search, validation, and dataset fetch operations.
- [Machine catalog](https://waypointreference.com/api/v1/catalog?src=llms): Resource identifiers, versions, operations, and limits.
- [API conventions and MCP first query](https://waypointreference.com/resources/docs/waypoint-api.md?src=llms): Search and row-schema validation through JSON HTTP and MCP, with a complete client example.
- [Assistant API](https://waypointreference.com/resources/docs/assistant-api.md?src=llms): Conversation tokens, request formats, and practical limits.
- REST search: POST https://waypointreference.com/api/v1/reference/search with Content-Type: application/json and {"query":"Waypoint directory","limit":5}; results include the waypoints dataset.
- MCP endpoint: https://waypointreference.com/mcp (Streamable HTTP; search_reference, get_resource, validate_records, ask_support). No model calls or account required.

## Datasets
- [Waypoint directory](https://waypointreference.com/resources/datasets/waypoints.md?src=llms): Twelve sample stations across three regions, with typed states and capacity values. 12 records; includes fields, a row schema, and the synthetic records. [JSON](https://waypointreference.com/resources/datasets/waypoints.json?src=llms)
- [Relay batches](https://waypointreference.com/resources/datasets/relay-batches.md?src=llms): Twelve sample transfers with source and destination references, lifecycle states, and payload units. 12 records; includes fields, a row schema, and the synthetic records. [JSON](https://waypointreference.com/resources/datasets/relay-batches.json?src=llms)
- [Relay lifecycle events](https://waypointreference.com/resources/datasets/relay-events.md?src=llms): Thirty-one ordered sample events for reconstructing batch state and joining station details. 31 records; includes fields, a row schema, and the synthetic records. [JSON](https://waypointreference.com/resources/datasets/relay-events.json?src=llms)

## Optional
- [Resource assistant](https://waypointreference.com/chat?src=llms): Ask about the schemas, examples, and fixture results.
- [Privacy and terms](https://waypointreference.com/privacy?src=llms): Who runs this research site, what is recorded about requests and conversations, and the terms of use. Do not submit secrets or private information.

Read the records array in each dataset document. Require matching versions before joining documents. Use IDs as exact join keys; sequence orders events only within one batch. A source link value is a navigation hint, not a client identity.