{
  "openapi": "3.0.1",
  "info": {
    "title": "OpenFEMA NFIP Flood Claims Scraper - Insurance Risk API",
    "description": "Search 2.7M+ official, privacy-redacted National Flood Insurance Program claim transactions by state, county FIPS, ZIP, community, flood event, year, flood zone, cause, or exact record ID. Returns payments, damage, coverage, building risk, and source evidence.",
    "version": "0.1",
    "x-build-id": "YHSJ0egQ3oqFaAobZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pink_comic~openfema-nfip-flood-insurance-claims/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pink_comic-openfema-nfip-flood-insurance-claims",
        "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/pink_comic~openfema-nfip-flood-insurance-claims/runs": {
      "post": {
        "operationId": "runs-sync-pink_comic-openfema-nfip-flood-insurance-claims",
        "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/pink_comic~openfema-nfip-flood-insurance-claims/run-sync": {
      "post": {
        "operationId": "run-sync-pink_comic-openfema-nfip-flood-insurance-claims",
        "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": {
          "claimId": {
            "title": "Exact OpenFEMA Claim Record ID",
            "minLength": 8,
            "type": "string",
            "description": "Exact source record UUID. Takes precedence over every other filter and returns at most one record."
          },
          "state": {
            "title": "State or Territory",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Two-letter abbreviation, such as FL, TX, LA, or PR."
          },
          "countyFips": {
            "title": "County FIPS",
            "pattern": "^[0-9]{5}$",
            "type": "string",
            "description": "Exact five-digit county FIPS code, such as 12071 for Lee County, Florida."
          },
          "zipCode": {
            "title": "Reported ZIP Code",
            "pattern": "^[0-9]{5}$",
            "type": "string",
            "description": "Exact five-digit ZIP code from the privacy-redacted source."
          },
          "communityId": {
            "title": "NFIP Community ID",
            "pattern": "^[A-Za-z0-9]{6,7}$",
            "type": "string",
            "description": "Exact current NFIP community identifier."
          },
          "communityName": {
            "title": "NFIP Community Name",
            "minLength": 2,
            "type": "string",
            "description": "Case-sensitive source substring, such as FORT MYERS BEACH or SANIBEL."
          },
          "floodEvent": {
            "title": "Flood Event",
            "minLength": 2,
            "type": "string",
            "description": "Case-sensitive event-name substring, such as Hurricane Ian or Hurricane Harvey."
          },
          "eventDesignationNumber": {
            "title": "Event Designation Number",
            "pattern": "^[A-Za-z0-9]{1,8}$",
            "type": "string",
            "description": "Exact FEMA event code, such as FL0222 for Hurricane Ian claims in Florida."
          },
          "yearOfLoss": {
            "title": "Year of Loss",
            "minimum": 1968,
            "maximum": 2027,
            "type": "integer",
            "description": "Calendar year when flood water first entered the insured building."
          },
          "causeOfDamage": {
            "title": "Cause of Damage Code",
            "pattern": "^[A-Za-z0-9]{1,8}$",
            "type": "string",
            "description": "Exact FEMA code: 1 tidal overflow, 2 river/lake overflow, 4 rainfall/snowmelt, or another documented code."
          },
          "floodZone": {
            "title": "Flood Zone",
            "type": "string",
            "description": "Exact current or rated NFIP flood zone, such as AE, VE, A, or X."
          },
          "paidOnly": {
            "title": "Paid Claims Only",
            "type": "boolean",
            "description": "Require a positive building, contents, or Increased Cost of Compliance claim payment.",
            "default": true
          },
          "sortBy": {
            "title": "Sort Results",
            "enum": [
              "latest",
              "oldest",
              "buildingPayment",
              "contentsPayment",
              "buildingDamage",
              "coverage"
            ],
            "type": "string",
            "description": "Order by loss date, reported payment, damage, or coverage.",
            "default": "latest"
          },
          "maxResults": {
            "title": "Maximum Claims",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Total response cap after all filters are applied.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}