Scale notes from root and mode API

Generates the notes of a scale from a root and mode (major, natural/harmonic/melodic minor, all seven church modes, major/minor pentatonic, blues, whole-tone, chromatic) with the W-H step pattern. Answers 'What notes are in C major?', 'Spell the A blues scale.'.

Price$0.04per request

MethodPOST

Route/v1/music/scale-notes

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

musicscalemodedorianpentatonicbluestheorynotesaudio

API URLhttps://x402.hexl.dev/v1/music/scale-notes

Integration docs

Example request

{
  "root": "C",
  "mode": "major"
}

Example response

{
  "root": "C4",
  "mode": "major",
  "fullName": "C Major (Ionian)",
  "degrees": [
    0,
    2,
    4,
    5,
    7,
    9,
    11
  ],
  "notes": [
    "C4",
    "D4",
    "E4",
    "F4",
    "G4",
    "A4",
    "B4"
  ],
  "pitchClasses": [
    0,
    2,
    4,
    5,
    7,
    9,
    11
  ],
  "stepPattern": "W-W-H-W-W-W",
  "noteCount": 7
}

Input schema

{
  "type": "object",
  "required": [
    "root"
  ],
  "properties": {
    "root": {
      "type": "string",
      "examples": [
        "C",
        "A"
      ]
    },
    "mode": {
      "type": "string",
      "examples": [
        "major",
        "minor",
        "dorian",
        "pentatonic-minor",
        "blues"
      ]
    },
    "octave": {
      "type": "number",
      "examples": [
        4
      ]
    },
    "preferFlats": {
      "type": "boolean"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}