Runic Calendar (runstaff)

POST

/runes/calendar

request.sh

curl -X POST https://api.astroway.info/v1/runes/calendar \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "2026-11-07" }'

▸ Спробувати POST /runes/calendar

• Production

The medieval Scandinavian runic calendar for a date: the day rune (fé, úr, þurs, óss, reið, kaun, hagall for letters A-G from 1 January), the year’s Sunday rune or runes (the dominical letter, two in a leap year) and the golden-number rune of the 19-year lunar cycle (the sixteen Younger Futhark runes plus arlaug, tvímaðr, belgþór).

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

4

Header Parameters

Idempotency-Key

string

>= 1 characters <= 255 characters /^[\x21-\x7E]+$/

Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with Idempotent-Replayed: true and costs 0 credits. The same key with a different body or query string is a 409 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running is a 409 IDEMPOTENCY_IN_PROGRESS. Only 2xx responses are kept. See /idempotency/.

Example

01HXY2A7ZM0ABCDEF

Request Body ^required

Media type application/json

object

date

YYYY-MM-DD; today (UTC) when omitted.

string

/^\d{4}-\d{2}-\d{2}$/

Example

{
  "date": "2026-11-07"
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

date

string

nullable

weekday

string

nullable

dayRune

object

letter

string

nullable

rune

string

nullable

name

string

nullable

dayOfYearCommon

number

nullable

sundayRunes

Array<object>

nullable

object

letter

string

nullable

rune

string

nullable

name

string

nullable

sundayRuneInForce

object

letter

string

nullable

rune

string

nullable

name

string

nullable

goldenNumber

object

number

number

nullable

rune

string

nullable

name

string

nullable

notes

Array<string>

nullable

source

string

nullable

Example

{
  "ok": true,
  "data": {
    "date": "2026-11-07",
    "weekday": "Saturday",
    "dayRune": {
      "letter": "C",
      "rune": "ᚦ",
      "name": "þurs",
      "dayOfYearCommon": 311
    },
    "sundayRunes": [
      {
        "letter": "D",
        "rune": "ᚬ",
        "name": "óss"
      }
    ],
    "sundayRuneInForce": {
      "letter": "D",
      "rune": "ᚬ",
      "name": "óss"
    },
    "goldenNumber": {
      "number": 13,
      "rune": "ᛒ",
      "name": "bjarkan"
    },
    "notes": [
      "Day runes repeat fé, úr, þurs, óss, reið, kaun, hagall (letters A to G) from 1 January and stay fixed to calendar dates; the leap day has no rune of its own.",
      "The Sunday rune is the dominical letter: the rune of the dates that fall on a Sunday this year. A leap year has two, the second from 1 March.",
      "The golden number is (year mod 19) + 1; on a runstaff its rune marks the days of the new moons of that year of the cycle. Numbers 17 to 19 use the added signs arlaug, tvímaðr and belgþór.",
      "Dates are read in the Gregorian calendar; staves made before the Swedish (1753) and Danish-Norwegian (1700) changes were Julian."
    ],
    "source": "Scandinavian runic calendars (runstav, primstav), 13th to 18th century: Younger Futhark day letters and golden-number runes with arlaug, tvímaðr, belgþór"
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}