API Specification - get readings for an hieroglyph

Get Readings JSON API

Description

The get_readings API returns the hieroglyph readings for a given Gardiner code

Location

https://www.gardinerhieroglyphs.com/api/get_readingscopy this url

Parameters

ParameterMeaningOptional?Format
gardinerGardiner codeMandatoryA - I, K - Z or Aa plus a number
languageLanguageOptional, default = ENEN, FR

Sample API Call

curl 'https://www.gardinerhieroglyphs.com/api/get_readings?g=A1'copy this url

Success

HTTP response code 200 OK

Successful response

{

 "data": {

  "readings": [

   {

    "gardiner": "A1",

    "glyph": "𓀀",

    "phonetic": "ꞽ",

    "pronunciation": "i",

    "mdc": "i",

    "meaning": "I, me, my (man)"

    "isLogogram": 1

    "entity": "G"

   },

     ↓

  ],

  "count": 4,

  "language": "EN",

  "timestamp": "2026-10-17T03:14:18+00:00"

 }

}

Error

HTTP response code 400 Bad Request

Error Response

{

 "errors": [

  {

   "error": "no hieroglyph found for gardiner code"

  },

  {

   "error": "please correct 1 error"

  }

 ]

}