Spec

Code snippets

curl "https://api.oanor.com/physics-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/physics-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/physics-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/physics-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "name": "Physics Motion API",
        "notes": "SI units (m, s, m/s, m/s²). Gravity defaults to 9.80665 m/s². Velocities from v²=u²+2as are returned as the positive root. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/kinematics",
                "params": {
                    "a": "acceleration",
                    "s": "displacement (give any three)",
                    "t": "time",
                    "u": "initial velocity",
                    "v": "final velocity"
                },
                "returns": "all five SUVAT quantities"
            },
            {
                "path": "/v1/projectile",
                "params": {
                    "angle": "launch angle degrees",
                    "height": "launch height m (optional)",
                    "gravity": "m/s² (default 9.80665)",
                    "velocity": "launch speed m/s"
                },
                "returns": "range, max height, flight time, impact speed"
            },
            {
                "path": "/v1/free-fall",
                "params": {
                    "time": "or a fall time s",
                    "height": "drop height m",
                    "gravity": "m/s²",
                    "initial_velocity": "m/s (optional)"
                },
                "returns": "fall time, distance and impact velocity"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Classical-mechanics maths as an API. The kinematics endpoint is a full SUVAT solver: give any three of initial velocity (u), final velocity (v), acceleration (a), time (t) and displacement (s) and it computes the rest using the standard constant-acceleration equations. The projectile endpoint takes a launch speed and angle (and an optional launch height and gravity) and returns the horizontal and vertical velocity components, the time to the peak, the maximum height, the total flight time, the range, and the impact speed. The free-fall endpoint computes a vacuum fall from a height or for a time, with an optional initial velocity, returning the fall time, distance and impact velocity. Gravity defaults to standard 9.80665 m/s² but can be set for other bodies. Everything is computed locally and deterministically in SI units, so it is instant and private. Ideal for physics education, engineering and simulation, game development, and ballistics and motion tools. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 4 endpoints. This is motion physics; for planetary data use a planets API and for unit conversion use a unit API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:07.073Z",
        "request_id": "3841f805-5bc5-4c0a-8542-aabdb4af49e6"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}