{
  "openapi": "3.1.0",
  "info": {
    "title": "SafePulse API",
    "description": "SafePulse — product safety intelligence: CPSC, FDA, USDA FSIS, NHTSA recalls; EU RAPEX; home safety scores; child/vehicle safety ratings; food safety alerts worldwide.",
    "version": "1.2.0",
    "contact": {
      "name": "The Aslan Group LLC",
      "url": "https://pulsenetwork.theaslangroupllc.com",
      "email": "info@theaslangroupllc.com"
    },
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Follow up with /clearcarepulse for healthcare cost estimates if injuries occur; /tradepulse for import compliance on recalled foreign goods; /nutripulse for food safety context.",
    "x-guidance": "# SafePulse API (x402 pay-per-call)\n\nUniversal product safety intelligence API. 9 endpoints: US recalls (CPSC + FDA + USDA + NHTSA), EU Safety Gate / RAPEX alerts (all 27 member states), global safety alerts (WHO + Canada + Australia + UK), consumer product incidents, vehicle safety, food/drug recalls, home hazards, child safety, and brand scoring A-F. Pay-per-query via x402 on Base.\n\nBase URL: https://safepulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/safe/recall — $0.08 — Active recall dashboard — CPSC, FDA, USDA, NHTSA consolidated with consumer actions\n- GET /api/safe/product — $0.08 — Consumer product safety — CPSC incident data, hazard patterns, safer alternatives\n- GET /api/safe/vehicle — $0.1 — Vehicle safety — NHTSA crash ratings, recalls, complaint analysis, buy guidance\n- GET /api/safe/food — $0.08 — Food/drug recall — FDA enforcement + USDA FSIS, Class I alerts, allergen flags\n- GET /api/safe/home — $0.1 — Home hazard intelligence — CPSC incident patterns by product or room, prevention checklist\n- GET /api/safe/child — $0.1 — Child product safety — choking/strangulation/button battery hazards, age filtering, emergency contacts\n- GET /api/safe/score — $0.12 — Brand safety score A-F based on CPSC incidents, FDA enforcement, recall rate vs. category peers\n- GET /api/safe/eu — $0.08 — EU Safety Gate (RAPEX) alerts — serious risk product recalls across all 27 EU member states with CE marking guidance\n- GET /api/safe/global — $0.1 — Global safety alerts — WHO pharmaceutical alerts, Health Canada, ACCC Australia, and UK OPSS in one consolidated report\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)."
  },
  "servers": [
    {
      "url": "https://safepulse.theaslangroupllc.com"
    }
  ],
  "paths": {
    "/api/safe/recall": {
      "get": {
        "summary": "Active recall dashboard",
        "description": "Consolidated active recalls across CPSC, FDA, USDA FSIS, and NHTSA with specific consumer actions",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "food",
                "drug",
                "vehicle",
                "product"
              ]
            },
            "description": "Filter by recall category"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Active recall digest"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/product": {
      "get": {
        "summary": "Consumer product safety",
        "description": "CPSC SaferProducts.gov incident data for any consumer product — hazard patterns, recall history, safer alternatives",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "toys | furniture | appliances | electronics | clothing"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Product safety report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/vehicle": {
      "get": {
        "summary": "Vehicle safety",
        "description": "NHTSA crash ratings, recall history, and owner complaint analysis for any make/model/year",
        "parameters": [
          {
            "name": "make",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Vehicle safety report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/food": {
      "get": {
        "summary": "Food and drug recall",
        "description": "FDA food/drug enforcement records and USDA FSIS recalls — contamination risk, allergen flags, Class I/II/III classification",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "food",
                "drug",
                "supplement",
                "all"
              ]
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Food/drug safety report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/home": {
      "get": {
        "summary": "Home safety hazards",
        "description": "CPSC incident patterns for household products and rooms — hazard profiles, prevention checklist, safety product recommendations",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "room",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "kitchen | bedroom | bathroom | garage | nursery"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Home safety report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/child": {
      "get": {
        "summary": "Child product safety",
        "description": "CPSC child-focused incident data — choking, strangulation, button battery hazards, age-group filtering, emergency contacts",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "age_group",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "infant | toddler | preschool | school-age"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Child safety report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/score": {
      "get": {
        "summary": "Brand safety score",
        "description": "Safety grade A-F for a brand based on CPSC incident history, FDA enforcement actions, and recall rate",
        "parameters": [
          {
            "name": "brand",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "product_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Safety score report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.12,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.120000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/eu": {
      "get": {
        "summary": "EU Safety Gate alerts",
        "description": "EU Safety Gate (RAPEX) product alerts across all 27 member states — serious risk recalls, CE marking guidance, cross-border availability warnings",
        "operationId": "safeEU",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "toys | electronics | clothing | food | cosmetics | vehicles | all"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Filter by EU country (e.g. Germany, France, Spain)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "EU product safety alerts"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/safe/global": {
      "get": {
        "summary": "Global safety alerts",
        "description": "International product safety — WHO pharmaceutical alerts, Health Canada, ACCC Australia, and UK OPSS in one consolidated report",
        "operationId": "safeGlobal",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "food | drug | device | consumer | all"
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "canada | australia | uk | who | global"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Global product safety alerts"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    }
  }
}