Notoriously Pedantic Magistrate


    1.0.0 • Public • Published

    npm versionCode Climatejs-standard-style


    A FDA Food Recall Enforcement provider for Koop

    How it works

    1. All the data is requested from the Open FDA food recalls enforcement API in pages
    2. States affected are parsed out of the distribution_pattern.
    3. Geometries are added to match the states from step 2 and merged into a single shape covering the area of the recall
    4. All results are converted into GeoJSON
    5. GeoJSON is loaded into Postgres
    6. Koop handles conversions to Esri Feature Services, KML, Shapefile, GeoJSON and CSV


    Note: the first time you run this it may kick off a very long process

    • Example requesting GeoJSON of all the zucchini recalls ever: where=product_description like '%zucchini%'
    • Example requesting a CSV of listeria cases in 2015: where=reason_for_recall like '%listeria%' AND recall_initiation_date >= 20150101
    • Example requesting a shapefile of all recalls of products originating in Texas: state = TX
      • Note: Make sure to capitalize the state or you will get no results
    • Example requesting kml of all ongoing class III recalls: where=status = Ongoing AND classification = 'Class III'


    1. In your Koop app register the koop-fda provider
    2. Get an API key from the FDA
    3. Add this to your koop config/default.json
          "key": "your key"


    Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.


    Copyright 2015 Esri

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

    A copy of the license is available in the repository's license.txt file.


    npm i koop-fda

    DownloadsWeekly Downloads






    Last publish


    • dmfenton