{
  "openapi": "3.0.1",
  "info": {
    "title": "FDA Drug Establishment Lookup - FEI, DUNS & Company",
    "description": "Look up FDA drug establishments in the official DECRS files by FEI, DUNS or an exact firm name, one site or up to 5,000. Export registration status, operations and address. This is a registration record, not an FDA approval or safety finding. Optionally monitor later changes.",
    "version": "0.1",
    "x-build-id": "gpngENr4oj1glEarX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automa-flow~fda-drug-establishment-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automa-flow-fda-drug-establishment-monitor",
        "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/automa-flow~fda-drug-establishment-monitor/runs": {
      "post": {
        "operationId": "runs-sync-automa-flow-fda-drug-establishment-monitor",
        "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/automa-flow~fda-drug-establishment-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-automa-flow-fda-drug-establishment-monitor",
        "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",
        "required": [
          "establishments"
        ],
        "properties": {
          "establishments": {
            "title": "Establishments to look up",
            "minItems": 1,
            "maxItems": 5000,
            "type": "array",
            "description": "One row per establishment. FEI is tried first, then DUNS, then normalized exact firm name. Multiple exact records are AMBIGUOUS rather than fuzzy-matched.",
            "items": {
              "type": "object",
              "properties": {
                "fei": {
                  "title": "FDA Establishment Identifier (FEI)",
                  "type": "string",
                  "description": "Preferred exact identifier. Leading zeroes are semantically normalized. FDA's live publication contains duplicate/reused FEIs, so add DUNS when known.",
                  "editor": "textfield",
                  "maxLength": 64
                },
                "duns": {
                  "title": "Establishment DUNS",
                  "type": "string",
                  "description": "Exact 9-digit establishment DUNS. Spaces and hyphens are ignored.",
                  "editor": "textfield",
                  "maxLength": 64
                },
                "name": {
                  "title": "Exact firm name",
                  "type": "string",
                  "description": "Exact fallback when FEI and DUNS are absent. Case, punctuation and repeated whitespace are normalized; no fuzzy match is ever selected.",
                  "editor": "textfield",
                  "maxLength": 512
                },
                "reference": {
                  "title": "Your reference",
                  "type": "string",
                  "description": "Optional ERP, procurement or supplier key echoed unchanged in this input row's output.",
                  "editor": "textfield",
                  "maxLength": 128
                }
              },
              "additionalProperties": false
            }
          },
          "includeAddress": {
            "title": "Include facility address",
            "type": "boolean",
            "description": "Include the official formatted facility address. Global subfields are populated only when they can be parsed reliably; country is extracted from FDA's country marker.",
            "default": true
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "snapshot",
              "monitor"
            ],
            "type": "string",
            "description": "snapshot returns the current official observation. monitor compares each normalized identity with its last successfully verified state.",
            "default": "snapshot"
          },
          "monitorId": {
            "title": "Monitor ID",
            "minLength": 1,
            "maxLength": 64,
            "type": "string",
            "description": "Required in monitor mode. Reuse the same 1-64 character list key on every scheduled run. Allowed: letters, digits, dots, underscores and hyphens."
          },
          "onlyChanges": {
            "title": "Minimize unchanged rows",
            "type": "boolean",
            "description": "In monitor mode every input still emits a reconciliation row, but unchanged rows omit repeated establishment profile details. Changed, baseline, ambiguous and failed rows remain explicit.",
            "default": false
          },
          "dueSoonDays": {
            "title": "Expiration warning window",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Add an EXPIRATION_DUE_SOON alert when a current registration expires within this many days.",
            "default": 90
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}