Skip to content
GET /v1/fret-position

Fret distance from the nut

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/guitar-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/guitar-api/v1/fret-position" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/guitar-api/v1/fret-position", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/guitar-api/v1/fret-position");
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/guitar-api/v1/fret-position",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "note": "Fret distance from the nut = scale length × (1 − 2^(−fret/12)) — equal temperament, where each fret is the twelfth root of two higher in pitch. The 12th fret sits exactly halfway (the octave), and the frets crowd together toward the bridge. The rule of 18 (≈ 17.817) is the old luthier's approximation of the same maths.",
        "inputs": {
            "fret_number": 12,
            "scale_length_in": 25.5
        },
        "distance_from_nut_in": 12.75,
        "remaining_to_bridge_in": 12.75,
        "spacing_from_previous_in": 0.7582
    },
    "meta": {
        "timestamp": "2026-06-06T23:54:00.359Z",
        "request_id": "6a20607d-cb93-480a-b00f-e4c6c5a6c276"
    },
    "status": "ok",
    "message": "Fret position",
    "success": true
}