{
  "openapi": "3.1.0",
  "info": {
    "title": "Birthdex reference API",
    "version": "1.1.0",
    "description": "Free static JSON reference data: birthstones, birth flowers, zodiac signs, and one endpoint per calendar date. No key, no rate limit. Traditional reference data, not predictions.",
    "license": {
      "name": "Free for personal and commercial use, attribution appreciated",
      "url": "https://birthdex.net/api-docs"
    }
  },
  "servers": [
    {
      "url": "https://birthdex.net"
    }
  ],
  "paths": {
    "/api/index.json": {
      "get": {
        "summary": "Index of the reference endpoints",
        "responses": {
          "200": {
            "description": "JSON reference data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/birthstones.json": {
      "get": {
        "summary": "Birthstones for all twelve months",
        "responses": {
          "200": {
            "description": "JSON reference data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/birth-flowers.json": {
      "get": {
        "summary": "Birth flowers for all twelve months",
        "responses": {
          "200": {
            "description": "JSON reference data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/zodiac.json": {
      "get": {
        "summary": "All twelve zodiac signs",
        "responses": {
          "200": {
            "description": "JSON reference data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/date/{month}-{day}.json": {
      "get": {
        "summary": "Everything tied to one calendar date",
        "responses": {
          "200": {
            "description": "JSON reference data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "month",
            "in": "path",
            "required": true,
            "description": "Zero-padded month, 01 to 12",
            "schema": {
              "type": "string",
              "pattern": "^(0[1-9]|1[0-2])$"
            }
          },
          {
            "name": "day",
            "in": "path",
            "required": true,
            "description": "Zero-padded day, 01 to 31",
            "schema": {
              "type": "string",
              "pattern": "^(0[1-9]|[12][0-9]|3[01])$"
            }
          }
        ]
      }
    }
  }
}