Free API

Free birthstone & zodiac JSON API

Birthdex publishes its reference data as free, static JSON. No API key, no rate limit, no sign-up. Fetch it from a browser, a build script or a backend, and build whatever you like.

Endpoints

Birthstones by month
/api/birthstones.json
Birth flowers by month
/api/birth-flowers.json
Zodiac signs
/api/zodiac.json

Fetch example

// Fetch every birthstone by month
const res = await fetch("https://birthdex.net/api/birthstones.json");
const data = await res.json();
console.log(data.months[11]);
// { month: "december", modern: "Turquoise", ... }

Zodiac response shape

The zodiac endpoint returns all twelve signs with their core reference facts.

{
  "signs": [
    {
      "slug": "leo",
      "name": "Leo",
      "symbol": "\u264c",
      "dateRange": "July 23 to August 22",
      "element": "Fire",
      "modality": "Fixed",
      "rulingPlanet": "The Sun",
      "birthstone": "Peridot"
    }
  ]
}

Using the data

The data is free to use in personal and commercial projects. A credit or link back to Birthdex is appreciated but not required. Each file includes an updated date so you can tell when it last changed. Because the endpoints are plain static files, they are fast, cacheable and CORS friendly.

What it does not do

This is reference data, not a horoscope service. It returns the traditional birthstone, birth flower and zodiac facts, not predictions or personalised readings. For a ready-made lookup interface, use the embeddable widget instead.

Last updated 2 July 2026.