← Back to API ReferenceEndpoint

GET /alphabet

Get the complete German alphabet with pronunciation guides, IPA notation, and example words.

GET/alphabet

Returns all 43 German alphabet entries including standard letters, umlauts (ä, ö, ü), and the Eszett (ß).

Authentication

Requires API key in the X-API-Key header.

X-API-Key: demo-key-12345

Parameters

This endpoint has no query parameters.

Request Example

cURL

curl -X GET "https://german-language.onrender.com/alphabet" \
  -H "X-API-Key: demo-key-12345"

JavaScript

const response = await fetch(
  "https://german-language.onrender.com/alphabet",
  {
    headers: { "X-API-Key": "demo-key-12345" }
  }
);
const data = await response.json();

Python

import requests

response = requests.get(
    "https://german-language.onrender.com/alphabet",
    headers={"X-API-Key": "demo-key-12345"}
)
data = response.json()

Response

Success Response

200 OK

{
  "count": 43,
  "data": [
    {
      "id": "alpha_001",
      "type": "letter",
      "letter": "A a",
      "name": "Ah",
      "pronunciation": "Like 'a' in 'father'",
      "example_word_de": "Apfel",
      "example_word_en": "apple",
      "ipa": "/aː/"
    },
    {
      "id": "alpha_002",
      "type": "letter",
      "letter": "B b",
      "name": "Beh",
      "pronunciation": "Like English 'b'",
      "example_word_de": "Buch",
      "example_word_en": "book",
      "ipa": "/beː/"
    },
    // ... more entries
  ]
}

Response Schema

Field	Type	Description
count	integer	Total number of alphabet entries
data	array	Array of alphabet entry objects

Alphabet Entry Object

Field	Type	Description
id	string	Unique identifier (e.g., "alpha_001")
type	string	"letter" for standard letters, "special" for umlauts/ß
letter	string	Upper and lowercase form (e.g., "A a")
name	string	German name of the letter
pronunciation	string	English pronunciation guide
example_word_de	string	German example word
example_word_en	string	English translation of example
ipa	string	IPA phonetic notation

Special German Characters

The German alphabet includes special characters not found in English:

Umlauts

Ä ä - A-umlaut

Ö ö - O-umlaut

Ü ü - U-umlaut

Eszett

ß - Sharp S

Represents "ss" sound, used after long vowels

Error Responses

401 Unauthorized

{
  "detail": "Invalid API key. Get a key at /register (coming soon)"
}

Try It Out

Test this endpoint in the API Playground.