API overview

Base URL: https://oramemory.com/api

All endpoints return a consistent envelope:

{
  "data":  { ... },
  "meta":  {
    "request_id":  "uuid",
    "duration_ms": 34,
    "warnings":    []
  },
  "error": null
}

On error, data is null and error carries the details. HTTP status codes follow REST conventions — see Errors & codes.

Versioning

Everything public lives under /api/v1. Breaking changes ship as /api/v2; the v1 path stays stable.

Content types

  • Requests: Content-Type: application/json
  • Responses: application/json; charset=utf-8

Rate limits

Every response includes X-Request-Id. Rate limits apply to writes only — see Plans & limits.

Next