Baby Age Calculator API

openapi: 3.1.0
info:
  title: Baby Age Calculator API
  version: '2026-11-02'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-02: 21 operation(s) read from 8 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Baby Age Calculator has published no machine-readable contract
    that the pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 0
    documentation: 21
    pages-with-code: 0
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-02'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://babyagecalculator.com/docs
  - https://babyagecalculator.com/docs/age
  - https://babyagecalculator.com/docs/zodiac
  - https://babyagecalculator.com/docs/birthstone
  - https://babyagecalculator.com/docs/milestones
  - https://babyagecalculator.com/docs/birthstones
  - https://babyagecalculator.com/llms.txt
  - https://babyagecalculator.com/skill
paths:
  /api:
    get:
      operationId: get_api
      tags:
      - Api
      summary: GET /api returns this list as JSON.
      description: Returns a list of available endpoints as JSON.
      x-source: https://babyagecalculator.com/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiResponse'
      x-evidence:
        kind: documentation
  /api/age:
    get:
      operationId: get_api_age
      tags:
      - Api
      summary: Get age, zodiac, birthstone and milestone information for a given birthday.
      x-source: https://babyagecalculator.com/llms.txt
      parameters:
      - name: birthday
        in: query
        required: true
        schema:
          type: string
        description: Birth date in YYYY-MM-DD format
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgeResponse'
      x-evidence:
        kind: documentation
  /api/age/:
    get:
      operationId: get_api_age
      tags:
      - Api
      summary: Age, zodiac, birthstone, and milestones for one birthday.
      x-source: https://babyagecalculator.com/skill
      parameters:
      - name: birthday
        in: query
        required: true
        schema:
          type: string
        description: Date of birth in YYYY-MM-DD format; must not be in the future.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgeResponse2'
      x-evidence:
        kind: documentation
  /api/age/Calculate:
    get:
      operationId: get_api_age_Calculate
      tags:
      - Api
      summary: Calculate a baby's age
      description: Turn a birth date into an exact age, zodiac sign, birthstone, milestones, and special days.
      x-source: https://babyagecalculator.com/docs/age
      parameters:
      - name: birthday
        in: query
        required: true
        schema:
          type: string
        description: The birth date as YYYY-MM-DD, not in the future.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgeCalculateResponse'
      x-evidence:
        kind: documentation
  /api/age/Turn:
    get:
      operationId: get_api_age_Turn
      tags:
      - Api
      summary: Turn a birth date into an exact age, zodiac sign, birthstone, milestones, and special days.
      description: Turns a birth date into an exact age, zodiac sign, birthstone, milestones, and special days.
      x-source: https://babyagecalculator.com/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgeTurnResponse'
      x-evidence:
        kind: documentation
  /api/birthstones:
    get:
      operationId: get_api_birthstones
      tags:
      - Api
      summary: List all birthstone months, each with its stones, colors and a guide URL.
      x-source: https://babyagecalculator.com/llms.txt
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBirthstonesResponse'
      x-evidence:
        kind: documentation
  /api/birthstones/:
    get:
      operationId: get_api_birthstones
      tags:
      - Api
      summary: Birthstones - all 12 months, or the full guide for one month.
      x-source: https://babyagecalculator.com/skill
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBirthstonesResponse2'
      x-evidence:
        kind: documentation
  /api/birthstones/{month}/:
    get:
      operationId: get_api_birthstones_month
      tags:
      - Api
      summary: Birthstones - full guide for one month.
      x-source: https://babyagecalculator.com/skill
      parameters:
      - name: month
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBirthstonesMonthResponse'
      x-evidence:
        kind: documentation
  /api/birthstones/{month}/Everything:
    get:
      operationId: get_api_birthstones_month_Everything
      tags:
      - Api
      summary: 'the month''s birthstone page shows: each stone''s colors, hardness, sources and story, plus keepsake ideas, a safety note, zodiac
        signs, and quick answers.'
      description: Provides detailed information for the specified month's birthstone, including colors, hardness, sources, story, keepsake ideas,
        safety note, zodiac signs, and quick answers.
      x-source: https://babyagecalculator.com/docs
      parameters:
      - name: month
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBirthstonesMonthEverythingResponse'
      x-evidence:
        kind: documentation
  /api/birthstones/{month}/Get:
    get:
      operationId: get_api_birthstones_month_Get
      tags:
      - Api
      summary: Get one month's birthstone guide
      description: One month's birthstone guide with colors, hardness, sources, story, keepsake ideas, safety note, zodiac signs, FAQ and source
        information.
      x-source: https://babyagecalculator.com/docs/birthstone
      parameters:
      - name: month
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBirthstonesMonthGetResponse'
      x-evidence:
        kind: documentation
  /api/documents:
    get:
      operationId: get_api_documents
      tags:
      - Api
      summary: Get the whole API as JSON - every endpoint with params, return fields, and a live example.
      x-source: https://babyagecalculator.com/llms.txt
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiDocumentsResponse'
      x-evidence:
        kind: documentation
  /api/milestones:
    get:
      operationId: get_api_milestones
      tags:
      - Api
      summary: List all milestone guides, each with a guide URL.
      x-source: https://babyagecalculator.com/llms.txt
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiMilestonesResponse'
      x-evidence:
        kind: documentation
  /api/milestones/:
    get:
      operationId: get_api_milestones
      tags:
      - Api
      summary: All 25 milestone types (name, emoji, group, and `day` = days from birth).
      x-source: https://babyagecalculator.com/skill
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiMilestonesResponse2'
      x-evidence:
        kind: documentation
  /api/milestones/All:
    get:
      operationId: get_api_milestones_All
      tags:
      - Api
      summary: 25 baby milestone guides with day count, age group, and a guide_url each.
      description: Provides 25 baby milestone guides with day count, age group, and a guide_url each.
      x-source: https://babyagecalculator.com/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiMilestonesAllResponse'
      x-evidence:
        kind: documentation
  /api/milestones/List:
    get:
      operationId: get_api_milestones_List
      tags:
      - Api
      summary: List all milestone guides
      description: All 25 baby milestone guides with day count, age group, and a guide_url each. One GET request, no key, no sign-up.
      x-source: https://babyagecalculator.com/docs/milestones
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiMilestonesListResponse'
      x-evidence:
        kind: documentation
  /api/milestones/Parameters:
    get:
      operationId: get_api_milestones_Parameters
      tags:
      - Api
      summary: Parameters endpoint
      description: None - just call it.
      x-source: https://babyagecalculator.com/docs/milestones
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/zodiac:
    get:
      operationId: get_api_zodiac
      tags:
      - Api
      summary: List all 12 zodiac signs, each with a guide URL.
      x-source: https://babyagecalculator.com/llms.txt
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiZodiacResponse'
      x-evidence:
        kind: documentation
  /api/zodiac/:
    get:
      operationId: get_api_zodiac
      tags:
      - Api
      summary: All 12 zodiac signs (name, dates, element, nickname, guide_url).
      x-source: https://babyagecalculator.com/skill
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiZodiacResponse2'
      x-evidence:
        kind: documentation
  /api/zodiac/All:
    get:
      operationId: get_api_zodiac_All
      tags:
      - Api
      summary: 12 zodiac signs with date ranges, element, nickname, and a guide_url each.
      description: Provides all 12 zodiac signs with date ranges, element, nickname, and a guide_url each.
      x-source: https://babyagecalculator.com/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiZodiacAllResponse'
      x-evidence:
        kind: documentation
  /api/zodiac/List:
    get:
      operationId: get_api_zodiac_List
      tags:
      - Api
      summary: List all zodiac signs
      description: All 12 zodiac signs with date ranges, element, nickname, and a guide_url each.
      x-source: https://babyagecalculator.com/docs/zodiac
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiZodiacListResponse'
      x-evidence:
        kind: documentation
  /api/zodiac/Parameters:
    get:
      operationId: get_api_zodiac_Parameters
      tags:
      - Api
      summary: None - just call it.
      description: No request parameters required; returns zodiac list metadata.
      x-source: https://babyagecalculator.com/docs/zodiac
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiZodiacParametersResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiResponse:
      type: object
      properties:
        code:
          type: string
          description: mirrors the HTTP status
        data:
          type: string
          description: the payload, null on error
        error:
          type: object
          description: null on success, {message} on error
        meta:
          type: object
          description: API name, docs links, attribution - same on every response
    GetApiAgeResponse:
      type: object
      properties:
        age:
          type: object
          description: Exact age in years, months, weeks, and days
        totals:
          type: object
          description: Total months, weeks, days, and hours since birth
        zodiac:
          type: object
          description: Zodiac sign details with dates, element, nickname and guide_url
        birthstone:
          type: object
          description: Birth month stones (list of name and colors) and guide_url
        current_milestone:
          type: object
          description: Latest milestone reached with guide_url
        next_milestone:
          type: object
          description: Next milestone with date, countdown and guide_url
        special_days:
          type: object
          description: Key special days (100 days, 200 days, first birthday, 1000 days) each with date, countdown and guide_url
        links:
          type: object
          description: Result page, guide lists and documentation links
    GetApiAgeResponse2:
      type: object
      properties:
        code:
          type: integer
          description: HTTP‑like status code of the API response.
        data:
          type: object
          description: Payload containing the calculated information.
        error:
          type: object
          description: Error object when the request fails.
        meta:
          type: object
          description: Metadata about the request/response.
        age:
          type: object
          description: Exact age broken into years, months, weeks, days, and a human‑readable string.
        totals:
          type: object
          description: Total months, weeks, days, and hours since birth.
        zodiac:
          type: object
          description: Zodiac sign details (name, emoji, dates, element, nickname, guide_url).
        birthstone:
          type: object
          description: Birthstone guide for the birth month (month, stones, guide_url).
        current_milestone:
          type: object
          description: Milestone that has already been reached (name, day, date, days_left, guide_url).
        next_milestone:
          type: object
          description: Upcoming milestone (name, day, date, days_left, guide_url).
        special_days:
          type: array
          description: Key dates such as 100 days, 200 days, 1st birthday, 1000 days (each with label, date, reached, days_left, guide_url).
        links:
          type: object
          description: Result page and guide URLs.
    GetApiAgeCalculateResponse:
      type: object
      properties:
        age:
          type: object
          description: Exact age in years, months, weeks, and days - plus a short human form.
        totals:
          type: object
          description: Total months, weeks, days, and hours since birth.
        zodiac:
          type: object
          description: The baby's sign with dates, element, nickname, and a guide_url.
        birthstone:
          type: object
          description: The birth month, its stones (always an array of { name, colors } - some months have three), and a guide_url.
        current_milestone:
          type: object
          description: The latest milestone reached (from 25 guides), with a guide_url. Null for newborns.
        next_milestone:
          type: object
          description: The next one coming up - date, days_left, and a guide_url. Null after 3 years.
        special_days:
          type: array
          description: 100 days, 200 days, first birthday, and 1000 days, each with status and a guide_url.
        links:
          type: object
          description: The result page, the guide lists, and the docs.
    GetApiAgeTurnResponse:
      type: object
      properties:
        code:
          type: string
          description: mirrors the HTTP status
        data:
          type: string
          description: the payload, null on error
        error:
          type: object
          description: null on success, {message} on error
        meta:
          type: object
          description: API name, docs links, attribution - same on every response
    GetApiBirthstonesResponse:
      type: object
      properties:
        months:
          type: array
          description: Array of month objects, each with month name, stones (list of name and colors) and guide_url
    GetApiBirthstonesResponse2:
      type: object
      properties:
        code:
          type: integer
          description: Response status code.
        data:
          type: array
          description: List of month objects each containing birthstone info.
        error:
          type: object
          description: Error details if any.
        meta:
          type: object
          description: Metadata about the request.
        month:
          type: string
          description: Month name.
        stones:
          type: array
          description: Array of stone objects (name, colors).
        guide_url:
          type: string
          description: URL to the birthstone guide for the month.
    GetApiBirthstonesMonthResponse:
      type: object
      properties:
        code:
          type: integer
          description: Response status code.
        data:
          type: object
          description: Birthstone guide for the requested month.
        error:
          type: object
          description: Error details if any.
        meta:
          type: object
          description: Metadata about the request.
        month:
          type: string
          description: Month name.
        stones:
          type: array
          description: Array of stone objects (name, colors).
        guide_url:
          type: string
          description: URL to the detailed birthstone guide.
    GetApiBirthstonesMonthEverythingResponse:
      type: object
      properties:
        code:
          type: string
          description: mirrors the HTTP status
        data:
          type: string
          description: the payload, null on error
        error:
          type: object
          description: null on success, {message} on error
        meta:
          type: object
          description: API name, docs links, attribution - same on every response
    GetApiBirthstonesMonthGetResponse:
      type: object
      properties:
        slug:
          type: string
          description: The month in lowercase, as used in the URL - e.g. november.
        month:
          type: string
          description: The month name - e.g. November.
        summary:
          type: string
          description: A short overview of the month's stones, in plain words.
        stones:
          type: array
          description: One entry per stone (1 to 3) with details.
        stones.name:
          type: string
          description: Stone name.
        stones.colors:
          type: string
          description: Colors of the stone.
        stones.hardness_mohs:
          type: string
          description: Hardness on the Mohs scale.
        stones.sources:
          type: string
          description: Where it is mined.
        stones.story:
          type: array
          description: List of traditions.
        meaning_for_baby:
          type: string
          description: What the stone traditionally means for a baby born this month.
        keepsake_ideas:
          type: array
          description: Keepsake and gift ideas for parents - none are jewelry for the baby.
        safety_note:
          type: string
          description: Safety note about not using jewelry or small stones on babies.
        zodiac_signs:
          type: array
          description: The two zodiac signs that share the month.
        zodiac_signs.name:
          type: string
          description: Zodiac sign name.
        zodiac_signs.emoji:
          type: string
          description: Zodiac sign emoji.
        zodiac_signs.days:
          type: string
          description: Day range for the sign.
        zodiac_signs.guide_url:
          type: string
          description: Link to the zodiac guide page.
        faq:
          type: array
          description: Short question and answer pairs.
        faq.question:
          type: string
          description: FAQ question.
        faq.answer:
          type: string
          description: FAQ answer.
        source_note:
          type: string
          description: Source of stone list and gem facts.
        guide_url:
          type: string
          description: Full guide page for this month.
    GetApiDocumentsResponse:
      type: object
      properties:
        code:
          type: integer
          description: HTTP status code of the response
        data:
          type: object
          description: Payload containing the API documentation
        error:
          type: string
          description: Error message if any
        meta:
          type: object
          description: Metadata with documentation links
    GetApiMilestonesResponse:
      type: object
      properties:
        milestones:
          type: array
          description: Array of milestone objects, each containing identifier and guide_url
    GetApiMilestonesResponse2:
      type: object
      properties:
        code:
          type: integer
          description: Response status code.
        data:
          type: array
          description: List of milestone types.
        error:
          type: object
          description: Error details if any.
        meta:
          type: object
          description: Metadata about the request.
        name:
          type: string
          description: Milestone name.
        emoji:
          type: string
          description: Emoji representing the milestone.
        group:
          type: string
          description: Category group of the milestone.
        day:
          type: integer
          description: Number of days from birth when the milestone occurs.
    GetApiMilestonesAllResponse:
      type: object
      properties:
        code:
          type: string
          description: mirrors the HTTP status
        data:
          type: string
          description: the payload, null on error
        error:
          type: object
          description: null on success, {message} on error
        meta:
          type: object
          description: API name, docs links, attribution - same on every response
    GetApiMilestonesListResponse:
      type: object
      properties:
        count:
          type: integer
          description: Always 25.
        slug:
          type: string
          description: Guide identifier.
        name:
          type: string
          description: Guide name.
        emoji:
          type: string
          description: Emoji representing the milestone.
        day:
          type: integer
          description: Day count for the milestone.
        group:
          type: string
          description: Group category (monthly | special-days | birthdays).
        special:
          type: boolean
          description: Indicates if the milestone is special.
        description:
          type: string
          description: Brief description of the milestone.
        guide_url:
          type: string
          description: URL to the full guide.
    GetApiZodiacResponse:
      type: object
      properties:
        signs:
          type: array
          description: Array of zodiac sign objects, each containing name and guide_url
    GetApiZodiacResponse2:
      type: object
      properties:
        code:
          type: integer
          description: Response status code.
        data:
          type: array
          description: List of zodiac sign objects.
        error:
          type: object
          description: Error details if any.
        meta:
          type: object
          description: Metadata about the request.
        name:
          type: string
          description: Zodiac sign name.
        dates:
          type: string
          description: Date range for the sign.
        element:
          type: string
          description: Element associated with the sign.
        nickname:
          type: string
          description: Common nickname for the sign.
        guide_url:
          type: string
          description: URL to the detailed guide.
    GetApiZodiacAllResponse:
      type: object
      properties:
        code:
          type: string
          description: mirrors the HTTP status
        data:
          type: string
          description: the payload, null on error
        error:
          type: object
          description: null on success, {message} on error
        meta:
          type: object
          description: API name, docs links, attribution - same on every response
    GetApiZodiacListResponse:
      type: object
      properties:
        code:
          type: integer
          description: HTTP status code of the response
        error:
          type: string
          description: Error message if any, otherwise null
        meta:
          type: object
          description: Metadata about the API
        data:
          type: object
          description: Payload containing zodiac data
    GetApiZodiacParametersResponse:
      type: object
      properties:
        code:
          type: integer
          description: HTTP status code of the response
        error:
          type: string
          description: Error message if any, otherwise null
        meta:
          type: object
          description: Metadata about the API
        data:
          type: object
          description: Payload containing count and signs array
tags:
- name: Api