{"openapi":"3.1.0","info":{"title":"Physics Motion API","version":"1.0.0","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 the Moon, Mars or any body. Everything is computed locally and deterministically in SI units, so it is instant and private. Ideal for physics education and homework, engineering and simulation, game and ballistics development, 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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/physics-api","description":"oanor gateway"}],"tags":[{"name":"Physics"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/free-fall":{"get":{"operationId":"get_v1_free_fall","tags":["Physics"],"summary":"Free fall (vacuum)","description":"","parameters":[{"name":"height","in":"query","required":false,"description":"Drop height m","schema":{"type":"string"},"example":"20"},{"name":"time","in":"query","required":false,"description":"Or a fall time s","schema":{"type":"string"}},{"name":"gravity","in":"query","required":false,"description":"m/s²","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mode":"from height","gravity":9.80665,"height_m":20,"fall_time_s":2.01962,"initial_velocity":0,"impact_velocity_m_s":19.8057},"meta":{"timestamp":"2026-06-03T17:42:06.803Z","request_id":"f4608d6d-d991-4a6f-bb04-6d345b21d5d7"},"status":"ok","message":"Free fall","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/kinematics":{"get":{"operationId":"get_v1_kinematics","tags":["Physics"],"summary":"SUVAT solver","description":"","parameters":[{"name":"u","in":"query","required":false,"description":"Initial velocity","schema":{"type":"string"},"example":"0"},{"name":"v","in":"query","required":false,"description":"Final velocity","schema":{"type":"string"}},{"name":"a","in":"query","required":false,"description":"Acceleration","schema":{"type":"string"},"example":"2"},{"name":"t","in":"query","required":false,"description":"Time","schema":{"type":"string"},"example":"5"},{"name":"s","in":"query","required":false,"description":"Displacement","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"a":2,"s":25,"t":5,"u":0,"v":10,"solved_for":["v","s"]},"meta":{"timestamp":"2026-06-03T17:42:06.921Z","request_id":"2a270334-0d69-4b9f-91cb-c7c99cc5ba8f"},"status":"ok","message":"Kinematics","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/projectile":{"get":{"operationId":"get_v1_projectile","tags":["Physics"],"summary":"Projectile motion","description":"","parameters":[{"name":"velocity","in":"query","required":true,"description":"Launch speed m/s","schema":{"type":"string"},"example":"20"},{"name":"angle","in":"query","required":true,"description":"Launch angle deg","schema":{"type":"string"},"example":"45"},{"name":"height","in":"query","required":false,"description":"Launch height m","schema":{"type":"string"}},{"name":"gravity","in":"query","required":false,"description":"m/s² (default 9.80665)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"vx":14.1421,"vy":14.1421,"gravity":9.80665,"range_m":40.7886,"velocity":20,"angle_deg":45,"max_height_m":10.1972,"flight_time_s":2.88419,"launch_height":0,"time_to_peak_s":1.4421,"impact_speed_m_s":20},"meta":{"timestamp":"2026-06-03T17:42:07.001Z","request_id":"3fa74b94-71eb-4a4d-9b4a-e8415acdd278"},"status":"ok","message":"Projectile","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7835,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":935,"monthly_call_quota":17350,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2925,"monthly_call_quota":224500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6725,"monthly_call_quota":1165000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/physics-api"}