{
  "openapi": "3.1.0",
  "info": {
    "title": "ParentPulse API",
    "version": "1.3.0",
    "description": "ParentPulse \u2014 child development and parenting intelligence: developmental milestones, nutrition guidance, pediatric health, sleep science, school selection, discipline strategies, childcare cost, and family finance. Evidence-based and globally aware.",
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Follow up with /nutripulse for detailed child nutrition plans; /clearcarepulse for pediatric cost estimates; /findpulse to locate specific parenting products."
  },
  "servers": [
    {
      "url": "https://parentpulse.theaslangroupllc.com"
    }
  ],
  "paths": {
    "/api/parent/milestone": {
      "get": {
        "summary": "Developmental milestone guidance (global)",
        "description": "WHO/CDC-grounded milestone context, red flags, and country-aware early intervention guidance (US Part C, UK SEND, Canada, Australia NDIS) by age and concern.",
        "parameters": [
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "18"
          },
          {
            "name": "concern",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "speech-delay"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "en"
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Milestone report"
          },
          "402": {
            "description": "Payment required \u2014 $0.10 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.1
      }
    },
    "/api/parent/safety": {
      "get": {
        "summary": "Product safety recall check (global)",
        "description": "Baby/child product recall lookup across CPSC/NHTSA (US), Safety Gate (EU), OPSS (UK), Health Canada, and ACCC (Australia).",
        "parameters": [
          {
            "name": "product_type",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "car-seat"
          },
          {
            "name": "brand",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "Graco"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Safety recall report"
          },
          "402": {
            "description": "Payment required \u2014 $0.08 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.08
      }
    },
    "/api/parent/school": {
      "get": {
        "summary": "School selection guidance (global)",
        "description": "Compare state/public, private/independent, charter, academy, and international school options by location, grade, and family priorities, with country-matched rating tools.",
        "parameters": [
          {
            "name": "zip",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "78701"
          },
          {
            "name": "grade",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "K"
          },
          {
            "name": "priorities",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "academics,arts"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "School comparison report"
          },
          "402": {
            "description": "Payment required \u2014 $0.10 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.1
      }
    },
    "/api/parent/activity": {
      "get": {
        "summary": "Activity and extracurricular finder (global)",
        "description": "Age-appropriate activities with cost estimates (currency-aware) and developmental benefits.",
        "parameters": [
          {
            "name": "age",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "7"
          },
          {
            "name": "interests",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "soccer,art"
          },
          {
            "name": "budget",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "200"
          },
          {
            "name": "zip",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "78701"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Activity recommendations"
          },
          "402": {
            "description": "Payment required \u2014 $0.08 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.08
      }
    },
    "/api/parent/finance": {
      "get": {
        "summary": "Family financial planning (global)",
        "description": "Education savings (529 US / RESP Canada / JISA-CTF UK), child benefit programs, dependent-care support, and cost-of-raising projections by country.",
        "parameters": [
          {
            "name": "children",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "2"
          },
          {
            "name": "ages",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "3,6"
          },
          {
            "name": "income",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "120000"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Family financial plan"
          },
          "402": {
            "description": "Payment required \u2014 $0.12 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.12
      }
    },
    "/api/parent/health": {
      "get": {
        "summary": "Pediatric symptom triage (global)",
        "description": "Urgency level guidance for common pediatric symptoms with the correct local emergency number \u2014 home care, when to call, when to seek emergency care.",
        "parameters": [
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "18"
          },
          {
            "name": "symptoms",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "fever,rash"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Triage report with urgency level"
          },
          "402": {
            "description": "Payment required \u2014 $0.10 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.1
      }
    },
    "/api/parent/sleep": {
      "get": {
        "summary": "Pediatric sleep guidance (global)",
        "description": "Age-appropriate sleep schedules, safe-sleep basics, training methods, and regression support.",
        "parameters": [
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "6"
          },
          {
            "name": "situation",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "night-waking"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Sleep guidance report"
          },
          "402": {
            "description": "Payment required \u2014 $0.10 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.1
      }
    },
    "/api/parent/nutrition": {
      "get": {
        "summary": "Pediatric nutrition guidance (global)",
        "description": "Feeding guidance by age \u2014 picky eating, allergen introduction, choking-hazard awareness, meal ideas \u2014 sourced from WHO/AAP/NHS-style guidelines.",
        "parameters": [
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "18"
          },
          {
            "name": "concern",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "picky-eater"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Nutrition guidance report"
          },
          "402": {
            "description": "Payment required \u2014 $0.10 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.1
      }
    },
    "/api/parent/discipline": {
      "get": {
        "summary": "Positive discipline guidance (global)",
        "description": "Age-appropriate behavioral strategies, in-the-moment scripts, and what's developmentally normal.",
        "parameters": [
          {
            "name": "age",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "4"
          },
          {
            "name": "behavior",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "tantrums"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Discipline guidance report"
          },
          "402": {
            "description": "Payment required \u2014 $0.10 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.1
      }
    },
    "/api/parent/childcare": {
      "get": {
        "summary": "Childcare options comparison (global)",
        "description": "Daycare vs nanny vs au pair vs childminder with local cost ranges, quality indicators, and country-specific subsidy programs.",
        "parameters": [
          {
            "name": "zip",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "78701"
          },
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "12"
          },
          {
            "name": "budget",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "2000"
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Country or region for jurisdiction-aware guidance (e.g. US, UK, Canada, Australia, Germany). Defaults to a generic/US-fallback response if omitted."
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "x402Payment": []
          }
        ],
        "responses": {
          "200": {
            "description": "Childcare comparison report"
          },
          "402": {
            "description": "Payment required \u2014 $0.12 USDC"
          }
        },
        "x-agent-use-case": "on-demand",
        "x-price-usd": 0.12
      }
    }
  },
  "components": {
    "securitySchemes": {
      "x402Payment": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "x402 micropayment signature. USDC on Base mainnet. Required: true.",
        "x-x402": true,
        "required": true
      }
    }
  }
}