Agent Harbor Recalls API

openapi: 3.2.0
info:
  title: Agent Harbor x402 Gateway Recalls API
  version: 1.0.0
  x-guidance: 'Pay-per-call business website data for agents. Every paid operation takes one bare domain (e.g. example.com). Call it unpaid to get HTTP 402 with the price; pay with x402 (USDC on Base, PAYMENT-SIGNATURE header) or, where offered, MPP (WWW-Authenticate: Payment, Tempo USDC) and retry. Failed or unusable calls are never charged. Cheapest first: /company, then /scrape; /enrich and /audit are the deeper tiers. Free: /catalog, /llms.txt, /SKILL.md, /.well-known/x402. Public-data routes (SEC EDGAR, recalls, package check, domain verification, PDF) take the query parameters listed in their own entries instead of a domain.'
  contact:
    name: Agent Harbor LLC
    email: anchor@agentharbor.agency
    url: https://agentharbor.agency
tags:
- name: Recalls
paths:
  /recalls:
    get:
      summary: Data Recalls
      operationId: data_recalls_recalls_get
      responses:
        '200':
          description: Served and charged.
          content:
            application/json:
              schema: {}
              example:
                product: recalls
                tier: recalls
                price_paid_usdc: 0.005
                data:
                  category: consumer
                  query: stroller
                  count: 3
                  results:
                  - source: CPSC
                    id: '26639'
                    date: '2026-07-23'
                    title: Peony Design Recalls Personalized Baby Bibs and Stroller Bags Due to Risk of Serious Injury or Death from Choking Hazard
                    description: This recall involves Peony Design personalized handmade baby bibs and stroller bags. The bibs have scalloped edges, a snap closure, and personalized embroidery on the front. The bibs were sold in fabric designs of geese, strawberries, heart tulip, plaid checks, and floral print. The stroller bags were made in coordinating fabrics including heart tulip, plaid check, floral print, and Winnie the Poo…
                    hazards:
                    - The snap can detach from the recalled bibs and stroller bags, posing a risk of serious injury or death from a choking hazard to young children.
                    remedies:
                    - Consumers should take the recalled baby bibs and stroller bags away from children immediately, stop using them, and contact Peony Design to receive a full refund. Consumers will be asked to discard the recalled baby bibs and stroller bags.
                    products:
                    - name: Personalized Baby Bibs and Stroller Bags
                      model: ''
                      units: About 52
                    manufacturers:
                    - Peony Design Co., of Howell, MI
                    retailers:
                    - Online at Etsy.com from October 2025 through July 2026 for between $15 and $45.
                    url: https://www.cpsc.gov/Recalls/2026/Peony-Design-Recalls-Personalized-Baby-Bibs-and-Stroller-Bags-Due-to-Risk-of-Serious-Injury-or-Death-from-Choking-Hazard
                  - source: CPSC
                    id: '26561'
                    date: '2026-06-18'
                    title: BABESIDE Doll and Stroller Children's Toys Recalled Due to Risk of Serious Injury or Death from Choking Hazard; Violate Small Parts Ban; Sold on Amazon by HYBDOLLS
                    description: This recall involves BABESIDE-branded doll and stroller toys. The play toy sets consist of a pink with red stroller, a baby doll dressed in pink and 23 accessories, including a pink and white plate with a fork and spoon, orange juice and milk feeding bottles, a toy pacifier with clip, a milk carton, a bib, a diaper bag, a diaper, a tissue bag with tissues, lotion and baby powder bottles, a small p…
                    hazards:
                    - The recalled toys violate the small parts ban because they are intended for children under three and the small pacifier poses a deadly choking hazard to young children. In addition, the eyes on the plush bear can detach, also posing a choking hazard.
                    remedies:
                    - Consumers should stop using the recalled toys' plush bear and pacifier immediately, take them away from children and contact HYBDOLLS for free replacement similar toy accessories, including shipping. Consumers will be asked to destroy the toy's plush bear and pacifier by cutting the bear in half and writing in permanent marker "X" on the pacifier and send a photo of the destroyed and marked access…
                    products:
                    - name: BABESIDE Doll and Stroller Toys
                      model: ''
                      units: About 2,200
                    manufacturers:
                    - Huizhou Huitong Crafts Co. Ltd., of China
                    retailers:
                    - Online at Amazon from July 2025 through January 2026 for about $40.
                    url: https://www.cpsc.gov/Recalls/2026/BABESIDE-Doll-and-Stroller-Childrens-Toys-Recalled-Due-to-Risk-of-Serious-Injury-or-Death-from-Choking-Hazard-Violate-Small-Parts-Ban-Sold-on-Amazon-by-HYBDOLLS
                  sources:
                  - https://www.saferproducts.gov/RestWebServices/Recall?format=json&ProductName=stroller
                  attribution: U.S. Consumer Product Safety Commission recalls (saferproducts.gov), public data.
                  note: Matches are text searches of official recall records; confirm the exact product, model and lot against the linked record.
                provider: Agent Harbor — public-data service
        '402':
          description: 'Payment required: x402 v2 PAYMENT-REQUIRED challenge (price, network, payTo).'
        '422':
          description: Invalid input, not found, or nothing usable to sell. Not charged.
        '502':
          description: Upstream failure. Not charged.
      description: 'Given a product or brand name (or a vehicle make, model and year), returns matching official U.S. recalls from CPSC (consumer products), NHTSA (vehicles) or FDA enforcement reports (food, drugs, medical devices), newest first, normalized to one shape: date, title or product, hazard or reason, remedy, classification, firm and a link to the record. An empty result is an answer. Not charged if a source is down.'
      x-payment-info:
        protocol: x402
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        price_usd: '0.005'
        payTo: '0x840C829530DF7B4CCF700Fa3A0060cF2C80b014e'
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402:
            version: 2
            scheme: exact
            network: eip155:8453
            asset: USDC
            amount: '5000'
            payTo: '0x840C829530DF7B4CCF700Fa3A0060cF2C80b014e'
      parameters:
      - name: category
        in: query
        required: true
        schema:
          type: string
          enum:
          - consumer
          - vehicle
          - food
          - drug
          - device
          example: consumer
        description: consumer, vehicle, food, drug or device
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 100
          example: stroller
        description: Product or brand text, 2-100 chars (not for vehicle)
      - name: make
        in: query
        required: false
        schema:
          type: string
          maxLength: 50
        description: Vehicle make, e.g. honda (vehicle only)
      - name: model
        in: query
        required: false
        schema:
          type: string
          maxLength: 50
        description: Vehicle model, e.g. civic (vehicle only)
      - name: year
        in: query
        required: false
        schema:
          type: string
          pattern: ^[0-9]{4}$
        description: Vehicle model year, e.g. 2020 (vehicle only)
      - name: limit
        in: query
        required: false
        schema:
          type: string
          pattern: ^[0-9]{1,2}$
          example: '3'
        description: Max results 1-25 (default 10)
      tags:
      - Recalls