Spec

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/fretspacing-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/fretspacing-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "notes": "Equal temperament: distance to fret n = scale × (1 − 1/2^(n/12)); 12th fret = half the scale. Inches or millimetres. For note names, frequencies or chords use a music-theory API.",
        "service": "fretspacing-api",
        "endpoints": {
            "GET /v1/fret": "Position of one fret (from the nut and from the previous fret).",
            "GET /v1/meta": "This document.",
            "GET /v1/positions": "All fret positions from the nut for a scale length.",
            "GET /v1/scalelength": "Scale length back-calculated from a measured distance to a fret."
        },
        "description": "Fretted-instrument lutherie maths: fret positions from a scale length, a single fret's position, and the scale length from a measured fret."
    },
    "meta": {
        "timestamp": "2026-06-06T07:13:57.146Z",
        "request_id": "3ca00617-70f1-46cc-9e9d-3d59ec960706"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}