{
  "openapi": "3.1.0",
  "info": {
    "title": "ParentPulse API",
    "version": "1.2.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.vercel.app"
    }
  ],
  "paths": {
    "/api/parent/milestone": {
      "get": {
        "summary": "Developmental milestone guidance",
        "description": "CDC and AAP milestone context, red flags, and early intervention guidance 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": "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",
        "description": "CPSC and NHTSA recall lookup for baby and child products.",
        "parameters": [
          {
            "name": "product_type",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "car-seat"
          },
          {
            "name": "brand",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "Graco"
          },
          {
            "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",
        "description": "Compare public, private, and charter schools by zip code, grade, and family priorities.",
        "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": "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",
        "description": "Age-appropriate activities with cost estimates 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": "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",
        "description": "529 college savings, dependent care FSA, child tax credit, and cost-of-raising projections.",
        "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": "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.1
      }
    },
    "/api/parent/health": {
      "get": {
        "summary": "Pediatric symptom triage",
        "description": "Urgency level guidance for common pediatric symptoms \u2014 home care, when to call, when to go to the ER.",
        "parameters": [
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "18"
          },
          {
            "name": "symptoms",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "fever,rash"
          },
          {
            "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",
        "description": "Age-appropriate sleep schedules, 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": "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.08
      }
    },
    "/api/parent/nutrition": {
      "get": {
        "summary": "Pediatric nutrition guidance",
        "description": "Feeding guidance by age \u2014 picky eating, allergen introduction, meal ideas.",
        "parameters": [
          {
            "name": "age_months",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "18"
          },
          {
            "name": "concern",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "picky-eater"
          },
          {
            "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",
        "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": "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.08
      }
    },
    "/api/parent/childcare": {
      "get": {
        "summary": "Childcare options comparison",
        "description": "Daycare vs nanny vs au pair with local cost ranges, quality indicators, and financial assistance.",
        "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": "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.1
      }
    }
  },
  "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
      }
    }
  }
}