Our RESTful API allows the user to collect data from catastrophe.world. This API exposes the endpoints for obtaining information about our three models:
\nStates - Descriptions and information about the states affected by natural disasters, organized into regions.
\nNatural Disasters - Statistics and information about natural disasters.
\nOrganizations - Information regarding organizations dedicated towards natural disaster relief.
Link to the website: catastrophe.world
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"5841816","collectionId":"0b83d1ea-d6ca-4101-aeea-45f995b5146d","publishedId":"S17wM6DE","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2019-03-28T19:09:26.000Z"},"item":[{"name":"Main Page","event":[{"listen":"test","script":{"id":"6fd3d007-891b-43e7-9b17-54a8f8d19739","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","","pm.test(\"Body matches string\", function () {"," pm.expect(pm.response.text()).to.include(\"This is the Catastrophe.World API\");","});"],"type":"text/javascript"}}],"id":"7dc54794-a579-4976-a5c7-494fdb2045e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"api.catastrophe.world/","description":"Request for Main Page of website.
\n","urlObject":{"path":[""],"host":["api","catastrophe","world"],"query":[],"variable":[]}},"response":[{"id":"5c44309d-fdfd-4edb-acef-e343da30eb95","name":"Main Page","originalRequest":{"method":"GET","header":[],"url":"api.catastrophe.world"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"This is the Catastrophe.World API\"\r\n}"}],"_postman_id":"7dc54794-a579-4976-a5c7-494fdb2045e7"},{"name":"Get States Models","event":[{"listen":"test","script":{"id":"7fea9d65-f0af-45cd-849d-a477a2564779","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","pm.test(\"Test Get States\", function () {"," var jsonData = pm.response.json();"," pm.expect(jsonData.length).to.eql(50);","});"],"type":"text/javascript"}}],"id":"e6b3903c-58d2-4ab5-85a1-7a31ea14869a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.catastrophe.world/states/?page=1&per_page=12&sortby=asc-name&pop_min=200000&pop_max=1000000&area_min=13210&area_max=100000®ion=West","description":"Returns a JSON string of all states within our model by using the /states endpoint. Optional query parameters include page, per_page, sortby, pop_min, pop_max, area_min, area_max, and region.
int - Page number used to index into results
int - Number to determine how many results should be presented on current page
enum - Used to sort results by a certain characteristic
int - Used to filter the minimum population a state should have in order to be displayed
int - Used to filter the maximum population a state should have in order to be displayed
int - Used to filter the minimum area a state should have in order to be displayed
int - Used to filter the maximum area a state should have in order to be displayed
enum - Used to filter the region that should be displayed
int - Page number used to index into results"},{"key":"per_page","value":"12","description":"int - Number to determine how many results should be presented on current page"},{"key":"sortby","value":"asc-name","description":"enum - Used to sort results by a certain characteristic"},{"key":"pop_min","value":"200000","description":"int - Used to filter the minimum population a state should have in order to be displayed"},{"key":"pop_max","value":"1000000","description":"int - Used to filter the maximum population a state should have in order to be displayed"},{"key":"area_min","value":"13210","description":"int - Used to filter the minimum area a state should have in order to be displayed"},{"key":"area_max","value":"100000","description":"int - Used to filter the maximum area a state should have in order to be displayed"},{"key":"region","value":"West","description":"enum - Used to filter the region that should be displayed"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"map\": \"https://upload.wikimedia.org/wikipedia/commons/5/5b/Wyoming_in_United_States.svg\",\n \"population_density\": \"5.97\",\n \"code\": \"WY\",\n \"name\": \"Wyoming\",\n \"capital\": \"Cheyenne\",\n \"climate\": \"Wyoming's climate is generally semi-arid and continental...Tornadoes, where they occur, tend to be small and brief, unlike some of those that occur farther east.\",\n \"region\": \"West\",\n \"area\": \"97914\",\n \"flag\": \"https://upload.wikimedia.org/wikipedia/commons/b/bc/Flag_of_Wyoming.svg\",\n \"population\": \"577737\"\n }\n]"}],"_postman_id":"e6b3903c-58d2-4ab5-85a1-7a31ea14869a"},{"name":"Get Natural Disasters","event":[{"listen":"test","script":{"id":"e1157a52-e89b-4d8c-977f-90f2701cf814","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","pm.test(\"Test Get Natural Disasters\", function () {"," var jsonData = pm.response.json();"," pm.expect(jsonData.length).to.eql(100);","});"],"type":"text/javascript"}}],"id":"99bef7da-b18e-400e-9024-ea5863a3fc3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"api.catastrophe.world/natural-disasters/?page=1&per_page=12&statecode=TX&sortby=asc-state&funding=32453534&incident=Flood","description":"Returns a JSON string of all natural disasters within our model by using the /natural-disasters endpoint. Optional query parameters include page, per_page, sortby, statecode, funding, and incident.
int - Page number used to index into results
int - Number to determine how many results should be presented on current page
enum - Used to filter results by what state it's located in
enum - Used to sort results by a certain characteristic
int - Used to filter results by FEMA funding given to certain disaster.
enum - Used to filter results by what type of incident it is
int - Page number used to index into results"},{"key":"per_page","value":"12","description":"int - Number to determine how many results should be presented on current page"},{"key":"statecode","value":"TX","description":"enum - Used to filter results by what state it's located in"},{"key":"sortby","value":"asc-state","description":"enum - Used to sort results by a certain characteristic"},{"key":"funding","value":"32453534","description":"int - Used to filter results by "},{"key":"incident","value":"Flood","description":"enum - Used to filter results by what type of incident it is"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"disastername\": \"SEVERE STORMS AND FLOODING \", \n \"obligatedfunding\": \"33293023\", \n \"statename\": \"Texas \", \n \"statecode\": \"TX\", \n \"incidenttype\": \"Flood\", \n \"approvedfunding\": \"45092244\", \n \"image\": \"http://www.weathernationtv.com/app/uploads/2018/10/aaa4.png\", \n \"declarationtype\": \"Major Disaster\", \n \"disasternumber\": \"4269\", \n \"declarationdate\": \"2016-04-25\"\n }, \n {\n \"disastername\": \"SEVERE STORMS AND FLOODING\", \n \"obligatedfunding\": \"62995482\", \n \"statename\": \"Texas \", \n \"statecode\": \"TX\", \n \"incidenttype\": \"Flood\", \n \"approvedfunding\": \"34042202\", \n \"image\": \"http://www.weathernationtv.com/app/uploads/2018/10/aaa4.png\", \n \"declarationtype\": \"Major Disaster\", \n \"disasternumber\": \"4272\", \n \"declarationdate\": \"2016-06-11\"\n }\n]"}],"_postman_id":"99bef7da-b18e-400e-9024-ea5863a3fc3b"},{"name":"Get Organizations","event":[{"listen":"test","script":{"id":"e3031d06-6059-4d93-95fd-3219057940a7","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","pm.test(\"Test Organizations\", function () {"," var jsonData = pm.response.json();"," pm.expect(jsonData.length).to.eql(38);","});"],"type":"text/javascript"}}],"id":"3ff95fca-7b5e-4a12-9f2a-a0c28066b647","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"api.catastrophe.world/organizations/?page=1&per_page=12&stateorprovince=TX&sortby=asc-name&rating=4","description":"Returns a JSON string of all organizations within our model by using the /organizations endpoint. Optional query parameters include page, per_page, sortby, stateorprovince, and rating.
int - Page number used to index into results
int - Number to determine how many results should be presented on current page
enum - Used to filter results by what state it's located in
enum - Used to sort results by a certain characteristic
int - Used to filter results by a numerical rating given by CharityNavigator.
int - Page number used to index into results"},{"key":"per_page","value":"12","description":"int - Number to determine how many results should be presented on current page"},{"key":"stateorprovince","value":"Texas","description":"enum - Used to filter results by what state it's located in"},{"key":"sortby","value":"asc-name","description":"enum - Used to sort results by a certain characteristic"},{"key":"rating","value":"4","description":"int - Used to filter results by a numerical rating"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"rating\": \"4\", \n \"image\": \"https://pbs.twimg.com/profile_images/736209268941033472/FyrUC1XS_400x400.jpg\", \n \"mission\": \"The mission of the Central Texas Food Bank is to nourish hungry people and lead the community in the fight against hunger.\", \n \"websiteurl\": \"http://www.centraltexasfoodbank.org\", \n \"charityname\": \"Central Texas Food Bank\", \n \"video\": \"//www.youtube.com/embed/o2BL1HemFXw\", \n \"year\": \"1981\", \n \"stateorprovince\": \"TX\", \n \"tagline\": \"Nourishing hungry people and leading the community in ending hunger\", \n \"social_media\": \"{https://www.facebook.com/CentralTexasFoodBank/,https://twitter.com/CTXFoodBank,https://www.instagram.com/CTXFoodBank}\", \n \"ein\": \"74-2217350\"\n }, \n {\n \"rating\": \"4\", \n \"image\": \"https://hiwirebrewing.com/wp-content/uploads/2017/11/habitat-for-humanity-logo-1030x1030.jpg\", \n \"mission\": \"Seeking to put God's love into action, Houston Habitat for Humanity brings people together to build homes, communities and hope.\", \n \"websiteurl\": \"http://www.houstonhabitat.org/\", \n \"charityname\": \"Houston Habitat for Humanity\", \n \"video\": \"//www.youtube.com/embed/B7dHHqQGQV0\", \n \"year\": \"\", \n \"stateorprovince\": \"TX\", \n \"tagline\": \"Building homes, communities and hope\", \n \"social_media\": \"{https://www.facebook.com/houstonhabitat,https://twitter.com/@houstonhabitat,https://www.youtube.com/user/houstonhabitat,https://www.pinterest.com/houstonhabitat,https://www.tumblr.com/houstonhabitat,https://www.flickr.com/houstonhabitat}\", \n \"ein\": \"76-0207084\"\n }, \n {\n \"rating\": \"4\", \n \"image\": \"http://getconnected.volunteerlubbock.org/content/getconnected.volunteerlubbock.org/agency/4043.jpg?1471372591\", \n \"mission\": \"The South Plains Food Bank, Inc. was founded in 1983. Through its various programs, the South Plains Food Bank, Inc. has become a humanitarian resource with responsibility for securing, growing, processing and/or distributing food to charitable organizations and persons in need. The South Plains Food Bank, Inc. strives to be a model for community partnerships and a catalyst for social change by providing opportunities for persons to break out of the poverty cycle.\\r\\n The South Plains Food Bank, Inc. is a member of Feeding America and the Texas Food Bank Network.\", \n \"websiteurl\": \"https://www.spfb.org/\", \n \"charityname\": \"South Plains Food Bank\", \n \"video\": \"//www.youtube.com/embed/WTj4wdCNZlM\", \n \"year\": \"1983\", \n \"stateorprovince\": \"TX\", \n \"tagline\": \"End Hunger. Give Hope. Enrich Lives.\", \n \"social_media\": \"{}\", \n \"ein\": \"75-1904829\"\n }, \n {\n \"rating\": \"4\", \n \"image\": \"https://mb.cision.com/Public/MigratedWpy/99458/9183766/ad914743b1477919_800x800ar.jpg\", \n \"mission\": \"OUR MISSION\\nTarrant Area Food Bank empowers communities to eliminate hunger by providing food, education and resources through innovation and collaboration.\\n\\nOUR VALUES\\nWe believe that access to healthy food is a basic human right and not a privilege. All people deserve regular, nutritious meals. \\n\\nOUR VISION\\nCommunities where no one has to go hungry.\\n\\nOUR SERVICE REGION\\nAs a regional clearinghouse for donated food, Tarrant Area Food Bank provides a nutritious mix of fresh, frozen and shelf-stable products to a network of hunger-relief charities and social services organizations in North Texas. These hunger-relief partners are located in urban, suburban and rural areas of Fort Worth and 13 surrounding counties with a total population of more than 3.3 million.\", \n \"websiteurl\": \"http://www.tafb.org/\", \n \"charityname\": \"Tarrant Area Food Bank\", \n \"video\": \"//www.youtube.com/embed/dvI2ncKm4lA\", \n \"year\": \"1982\", \n \"stateorprovince\": \"TX\", \n \"tagline\": \"Empowering North Texas communities to eliminate hunger\", \n \"social_media\": \"{https://www.facebook.com/https://www.facebook.com/TAFoodBank,https://twitter.com/https://twitter.com/TAFoodBank,https://plus.google.com/https://plus.google.com/+TarrantAreaFoodBank,https://www.linkedin.com/company/https://www.linkedin.com/company/tarrant-area-food-bank,https://www.youtube.com/user/https://www.youtube.com/user/TarrantAreaFoodBank}\", \n \"ein\": \"75-1822473\"\n }\n]"}],"_postman_id":"3ff95fca-7b5e-4a12-9f2a-a0c28066b647"},{"name":"Get Specifc State","event":[{"listen":"test","script":{"id":"c69e3dfd-1a0a-409e-be47-4f6b8cbb60da","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","","pm.test(\"Get Specific State\", function () {"," var jsonData = pm.response.json();"," pm.expect(jsonData.code).to.eql('TX');","});"],"type":"text/javascript"}}],"id":"fe0c3f46-77dd-425b-9dbe-36ac42a69c26","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"api.catastrophe.world/states/TX","description":"Returns a JSON string of a specific states and its associated information by adding /state/<CODE> to the endpoint. Note that the state code must be CAPIALIZED.
","host":["api","catastrophe","world"],"path":["states",""],"query":[{"key":"","value":"","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{ \"map\": \"https://upload.wikimedia.org/wikipedia/commons/a/ad/Texas_in_United_States.svg\", \"population_density\": \"108\", \"code\": \"TX\", \"name\": \"Texas\", \"capital\": \"Austin\", \"area\": \"268,581\", \"flag\": \"https://upload.wikimedia.org/wikipedia/commons/f/f7/Flag_of_Texas.svg\", \"population\": \"28,701,845\" }"}],"_postman_id":"fe0c3f46-77dd-425b-9dbe-36ac42a69c26"},{"name":"Get Specific Natural Disaster","event":[{"listen":"test","script":{"id":"1e509b9b-0177-4ead-bbf7-49329fe846e3","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","","pm.test(\"Get Specific Disaster\", function () {"," var jsonData = pm.response.json();"," pm.expect(jsonData.disastername).to.eql('TROPICAL STORM NATE');","});"],"type":"text/javascript"}}],"id":"5f1579ef-aacc-4805-837f-e23adceed3f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"api.catastrophe.world/natural-disasters/3392","description":"Returns a JSON string of a specific natural disaster and its associated information by adding /natural-disasters/<disasternumber> to the endpoint.
\n","urlObject":{"path":["natural-disasters","3392"],"host":["api","catastrophe","world"],"query":[],"variable":[]}},"response":[{"id":"4c08c012-a62f-4dd8-babb-34c29b0d30f1","name":"Get Specific Natural Disaster","originalRequest":{"method":"GET","header":[],"url":"api.catastrophe.world/natural-disasters/"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{ \"disastername\": \"TROPICAL STORM GITA\", \"statename\": \"American Samoa \", \"statecode\": \"AS\", \"incidenttype\": \"Hurricane\", \"declarationtype\": \"Emergency\", \"disasternumber\": \"3397\", \"declarationdate\": \"2018-02-11\" }"}],"_postman_id":"5f1579ef-aacc-4805-837f-e23adceed3f8"},{"name":"Get Specific Organization","event":[{"listen":"test","script":{"id":"48916d87-1bf3-497f-8ef0-987cc1d27f14","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});","","pm.test(\"Get Specific Organization\", function () {"," var jsonData = pm.response.json();"," pm.expect(jsonData.stateorprovince).to.eql('CA');","});"],"type":"text/javascript"}}],"id":"7cef1b05-2e5d-4886-9150-18ec6e093d32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"api.catastrophe.world/organizations/943088881","description":"Returns a JSON string of a specific organization and its associated information by adding /organization/<ein> to the endpoint.
\n","urlObject":{"path":["organizations","943088881"],"host":["api","catastrophe","world"],"query":[],"variable":[]}},"response":[{"id":"6fc2ef97-47b3-488b-bef2-c6eb659d4c89","name":"Get Specific Organization","originalRequest":{"method":"GET","header":[],"url":"api.catastrophe.world/organizations/"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{ \"tagline\": \"Strengthening families and communities\", \"image\": \"https://d20umu42aunjpx.cloudfront.net/_gfx_/causes/small/housing.gif?utm_source=DataAPI&utm_content=9af5afa3\", \"websiteurl\": \"http://www.cincinnatihabitat.org/\", \"charityname\": \"Cincinnati Habitat for Humanity\", \"stateorprovince\": \"OH\", \"ein\": \"311185975\" }"}],"_postman_id":"7cef1b05-2e5d-4886-9150-18ec6e093d32"}],"event":[{"listen":"prerequest","script":{"id":"adf7f7c7-5758-4cdb-94d7-0abcc537bc2e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"ca743627-e2af-4b57-96e8-99b6bc545a4c","type":"text/javascript","exec":[""]}}]}