Reference API

API Reference

Base URL: https://api.glintstone.org

No authentication required. All read endpoints are publicly accessible. The collections endpoints support write operations.

Error shape

{ "detail": "Human-readable message" }

Code	Meaning
404	Resource not found
422	Validation error (invalid query parameter)
500	Internal server error

Pagination

List endpoints accept page (1-based, default 1) and per_page (default 24). The response includes total, page, and per_page.

{
  "items": [...],
  "total": 353283,
  "page": 1,
  "per_page": 24
}

Endpoint groups

Group	Description
Artifacts	Search, detail, ATF, images, lemmas
Search & Agentic	Hybrid semantic search, AI summaries, token interpretation, corrections
Dictionary	Signs, lemmas, glosses, written-form lookup
Collections	Personal research sets (read/write)
Composites	Multi-tablet composite texts (Q-numbers)
Stats & Meta	Aggregate counts, health check, version, image serving

The interactive Swagger UI is at api.glintstone.org/docs.