{
  "openapi": "3.0.1",
  "info": {
    "title": "FDA Recalls & 510(k) Clearances Scraper (openFDA API)",
    "description": "FDA medical device, drug and food recalls (enforcement reports) and 510(k) device clearances from the public openFDA API. Filter by class, status, keyword, firm, state and date. Newest first. Regulatory monitoring and medtech competitive intelligence. No API key needed.",
    "version": "0.2",
    "x-build-id": "gl6euw8CacXzSbftM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/groundplanes~openfda-recalls-510k/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-groundplanes-openfda-recalls-510k",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/groundplanes~openfda-recalls-510k/runs": {
      "post": {
        "operationId": "runs-sync-groundplanes-openfda-recalls-510k",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/groundplanes~openfda-recalls-510k/run-sync": {
      "post": {
        "operationId": "run-sync-groundplanes-openfda-recalls-510k",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "dataset": {
            "title": "openFDA Dataset",
            "enum": [
              "device_enforcement",
              "drug_enforcement",
              "food_enforcement",
              "device_510k"
            ],
            "type": "string",
            "description": "Select which openFDA endpoint to query: device_enforcement, drug_enforcement, food_enforcement, or device_510k.",
            "default": "device_enforcement"
          },
          "classifications": {
            "title": "Recall Classifications (Enforcement Only)",
            "type": "array",
            "description": "FDA recall hazard classifications to include (applies to enforcement datasets only; ignored for device_510k and logged at runtime when supplied for device_510k). Leave empty for all classifications.",
            "items": {
              "type": "string",
              "enum": [
                "Class I",
                "Class II",
                "Class III",
                "Not Yet Classified"
              ],
              "enumTitles": [
                "Class I (Highest Risk / Serious Adverse Health Consequences)",
                "Class II (Temporary or Medically Reversible Health Consequences)",
                "Class III (Unlikely to Cause Adverse Health Consequences)",
                "Not Yet Classified"
              ]
            },
            "default": [
              "Class I",
              "Class II"
            ]
          },
          "statuses": {
            "title": "Recall Statuses (Enforcement Only)",
            "type": "array",
            "description": "Optional recall statuses (Ongoing, Completed, Terminated, Pending). Applies to enforcement datasets only; ignored for device_510k and logged at runtime when supplied for device_510k. Note: Pending currently has zero live records in the source. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "Ongoing",
                "Completed",
                "Terminated",
                "Pending"
              ],
              "enumTitles": [
                "Ongoing",
                "Completed",
                "Terminated",
                "Pending"
              ]
            },
            "default": []
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Optional keywords matched against product_description or reason_for_recall (or device_name for device_510k). Multiple keywords use OR semantics: a record matching any keyword is included.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "firmName": {
            "title": "Firm or Applicant Name",
            "type": "string",
            "description": "Optional company name matched against recalling_firm (enforcement) or applicant (device_510k).",
            "default": ""
          },
          "states": {
            "title": "US States",
            "type": "array",
            "description": "Optional 2-letter US state codes (e.g. [\"CA\", \"MN\", \"MA\"]). Leave empty for all states.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "dateFrom": {
            "title": "Date From (YYYY-MM-DD)",
            "type": "string",
            "description": "Start of report_date (enforcement; must be >= 2012-06-20) or decision_date (device_510k). Leave empty for today minus 90 days."
          },
          "dateTo": {
            "title": "Date To (YYYY-MM-DD)",
            "type": "string",
            "description": "End of report_date (enforcement) or decision_date (device_510k). Leave empty for today."
          },
          "openFdaApiKey": {
            "title": "openFDA API Key (Optional)",
            "type": "string",
            "description": "Optional free api.fda.gov key supplied by the user for their own quota (raises the daily quota from 1,000 to 120,000 requests/day). This is a user-supplied optional key for a public API, kept as a secret input field; it is not an operator secret."
          },
          "maxItems": {
            "title": "Maximum Items",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of recall or 510(k) records to output.",
            "default": 200
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}