CINXE.COM

<!DOCTYPE html> <html lang="en"> <head> <title> IUCN Red List API </title> <meta name="viewport" content="width=device-width,initial-scale=1"> <meta name="description" content="The IUCN Red List of Threatened Species™"> <meta name="csrf-param" content="authenticity_token" /> <meta name="csrf-token" content="kj_aEZZaNiEwIyMg1R0Rvxt_HM6pffbldRxYCC39ccREJzXXcdYunSeGebsQpBFZcUu5eP3fQcFHg4updQ8dHA" /> <link rel="icon" type="image/x-icon" href="/assets/ico/favicon-8c0d018c700a02be136ebf932617e12458cd35bbb05fe950d32cdb349dda4fb6.ico" /> <link rel="stylesheet" href="/assets/tailwind-29399c4a72a4c9ab478f893a00ab33f5217525881d9a6215485e872decf15623.css" data-turbo-track="reload" /> <link rel="stylesheet" href="/assets/inter-font-8c3e82affb176f4bca9616b838d906343d1251adc8408efe02cf2b1e4fcf2bc4.css" data-turbo-track="reload" /> <link rel="stylesheet" href="/assets/application-41dd3fee0f311613c8b35186f1f2172729d744dc102c05f1cbfef1e323e9ddd4.css" data-turbo-track="reload" /> <script type="importmap" data-turbo-track="reload">{ "imports": { "application": "/assets/application-a51d9fddc00785fe72e9831cff7e8aed73e8e22d6bfcc04c03356e9c2eac21b5.js", "@hotwired/turbo-rails": "/assets/turbo.min-4cfe7c6aaeb9120821760aa53763dff54fbc561e500da6482fc43c54c7384929.js", "@hotwired/stimulus": "/assets/stimulus.min-dd364f16ec9504dfb72672295637a1c8838773b01c0b441bd41008124c407894.js", "@hotwired/stimulus-loading": "/assets/stimulus-loading-3576ce92b149ad5d6959438c6f291e2426c86df3b874c525b30faad51b0d96b3.js", "@stimulus-components/scroll-to": "/assets/@stimulus-components--scroll-to-f674996091cb0f0c9c918919712b3b1b937848b7a3223d8993b5e8356ebb391d.js", "chartkick": "/assets/chartkick-8eb76e6cbdb540d495739fce84049fd038e59e7fd55c9e08e47b0b5a74b62db4.js", "Chart.bundle": "/assets/Chart.bundle-545c7dd29b3aabbf63c41f01186053ea7a673254f2cbb405b88182510983ac55.js", "trix": "/assets/trix-686ab55c2aea8035a7f728b61ec7afedfe857f70d6279ab453da775b7469e9e8.js", "@rails/actiontext": "/assets/actiontext.esm-328ef022563f73c1b9b45ace742bd21330da0f6bd6c1c96d352d52fc8b8857e5.js", "@stimulus-components/dropdown": "/assets/@stimulus-components--dropdown-2cb62066aba0a8b16a2dd9a3c773d15bb7f1003d6759c49ad91b2f51b801efed.js", "stimulus-use": "/assets/stimulus-use-223d8e394baaa4871e4cb752a2e55006c163f6e3514f59b6ac415031f5d21ba7.js", "leaflet": "/assets/leaflet-1ff69389014a18c608b592e65d97e24f63d9582e02ab27d42386857456e36c8e.js", "leaflet-css": "/assets/leaflet-css-055c8dc95712f4bc89d94c16998c48a05970b1dc61504ed3848f30657a6895f5.js", "controllers/application": "/assets/controllers/application-3f7c6ca6136427e38fb0affc2f5ef45d7e1a47c4f8817679cc36ef7d24732810.js", "controllers/assessment_details_toggle_controller": "/assets/controllers/assessment_details_toggle_controller-738001029143b3cedaa3ab8f46627db58128de0ef62f52eb0d70383b7d6dccee.js", "controllers/assessment_distribution_map_controller": "/assets/controllers/assessment_distribution_map_controller-0dee56d1d3f9d72150efc8d3e2ab27c5d119c032dcf44481bd83c7300eeb9ddc.js", "controllers/dropdown_controller": "/assets/controllers/dropdown_controller-bf19e70ff552ac494cfd377ac2ada68dfe703e8263cc6b8e3f85c80cb593d3ff.js", "controllers/form_submission_controller": "/assets/controllers/form_submission_controller-62b71092f0170175f25ba0d460653c5d70b69f7e57401ab500614320684190c9.js", "controllers/hello_controller": "/assets/controllers/hello_controller-549135e8e7c683a538c3d6d517339ba470fcfb79d62f738a0a089ba41851a554.js", "controllers": "/assets/controllers/index-2db729dddcc5b979110e98de4b6720f83f91a123172e87281d5a58410fc43806.js", "controllers/species_three_sixty_map_controller": "/assets/controllers/species_three_sixty_map_controller-f7eba793a8d590d58da9351e1caae494a5931483b34fc42a5d17e9f8ec141c6d.js", "controllers/turbo_modal_controller": "/assets/controllers/turbo_modal_controller-85497f193bc0c4b5c4d9017b50a2581077440f2c0879271af69a570de6bf7c55.js", "controllers/visibility_controller": "/assets/controllers/visibility_controller-23c8c3258621c396efbe404fa189ddd61972df3602e1ffb287d08a772714b0ed.js" } }</script> <link rel="modulepreload" href="/assets/application-a51d9fddc00785fe72e9831cff7e8aed73e8e22d6bfcc04c03356e9c2eac21b5.js"> <link rel="modulepreload" href="/assets/turbo.min-4cfe7c6aaeb9120821760aa53763dff54fbc561e500da6482fc43c54c7384929.js"> <link rel="modulepreload" href="/assets/stimulus.min-dd364f16ec9504dfb72672295637a1c8838773b01c0b441bd41008124c407894.js"> <link rel="modulepreload" href="/assets/stimulus-loading-3576ce92b149ad5d6959438c6f291e2426c86df3b874c525b30faad51b0d96b3.js"> <link rel="modulepreload" href="/assets/@stimulus-components--scroll-to-f674996091cb0f0c9c918919712b3b1b937848b7a3223d8993b5e8356ebb391d.js"> <link rel="modulepreload" href="/assets/chartkick-8eb76e6cbdb540d495739fce84049fd038e59e7fd55c9e08e47b0b5a74b62db4.js"> <link rel="modulepreload" href="/assets/Chart.bundle-545c7dd29b3aabbf63c41f01186053ea7a673254f2cbb405b88182510983ac55.js"> <link rel="modulepreload" href="/assets/trix-686ab55c2aea8035a7f728b61ec7afedfe857f70d6279ab453da775b7469e9e8.js"> <link rel="modulepreload" href="/assets/actiontext.esm-328ef022563f73c1b9b45ace742bd21330da0f6bd6c1c96d352d52fc8b8857e5.js"> <link rel="modulepreload" href="/assets/@stimulus-components--dropdown-2cb62066aba0a8b16a2dd9a3c773d15bb7f1003d6759c49ad91b2f51b801efed.js"> <link rel="modulepreload" href="/assets/stimulus-use-223d8e394baaa4871e4cb752a2e55006c163f6e3514f59b6ac415031f5d21ba7.js"> <link rel="modulepreload" href="/assets/leaflet-1ff69389014a18c608b592e65d97e24f63d9582e02ab27d42386857456e36c8e.js"> <link rel="modulepreload" href="/assets/leaflet-css-055c8dc95712f4bc89d94c16998c48a05970b1dc61504ed3848f30657a6895f5.js"> <link rel="modulepreload" href="/assets/controllers/application-3f7c6ca6136427e38fb0affc2f5ef45d7e1a47c4f8817679cc36ef7d24732810.js"> <link rel="modulepreload" href="/assets/controllers/assessment_details_toggle_controller-738001029143b3cedaa3ab8f46627db58128de0ef62f52eb0d70383b7d6dccee.js"> <link rel="modulepreload" href="/assets/controllers/assessment_distribution_map_controller-0dee56d1d3f9d72150efc8d3e2ab27c5d119c032dcf44481bd83c7300eeb9ddc.js"> <link rel="modulepreload" href="/assets/controllers/dropdown_controller-bf19e70ff552ac494cfd377ac2ada68dfe703e8263cc6b8e3f85c80cb593d3ff.js"> <link rel="modulepreload" href="/assets/controllers/form_submission_controller-62b71092f0170175f25ba0d460653c5d70b69f7e57401ab500614320684190c9.js"> <link rel="modulepreload" href="/assets/controllers/hello_controller-549135e8e7c683a538c3d6d517339ba470fcfb79d62f738a0a089ba41851a554.js"> <link rel="modulepreload" href="/assets/controllers/index-2db729dddcc5b979110e98de4b6720f83f91a123172e87281d5a58410fc43806.js"> <link rel="modulepreload" href="/assets/controllers/species_three_sixty_map_controller-f7eba793a8d590d58da9351e1caae494a5931483b34fc42a5d17e9f8ec141c6d.js"> <link rel="modulepreload" href="/assets/controllers/turbo_modal_controller-85497f193bc0c4b5c4d9017b50a2581077440f2c0879271af69a570de6bf7c55.js"> <link rel="modulepreload" href="/assets/controllers/visibility_controller-23c8c3258621c396efbe404fa189ddd61972df3602e1ffb287d08a772714b0ed.js"> <script type="module">import "application"</script> </head> <body class="page-home"> <div class="layout-site" id="page" role="document"> <div class="layout-iconic-species-banner" role="banner"> <a href="https://iconicspecies.iucnredlist.org"> <img alt="The most iconic things are not things. Donate now." src="/assets/red_list_iconic_species-fdceecc62552ad7e3ba6bdb105f0676a339d35796525e8606d2a1a983fe57ddc.png" /> </a> </div> <div role="navigation" aria-label="account-navigation" class="relative isolate flex items-center gap-x-6 overflow-hidden bg-red-700 px-6 py-2.5 sm:px-3.5 sm:before:flex-1"> <p class="text-sm leading-6 text-white pl-2 pr-2 rounded bg-red-600"> Beta </p> <div class="flex flex-1 justify-end"> <p class="text-sm leading-6 text-white pr-1"> 2024-2 </p> <p class="text-sm leading-6 text-white pr-1">|</p> <a href="https://www.iucnredlist.org" class="text-sm leading-6 text-white pr-1 underline hover:decoration-2">Website</a> <p class="text-sm leading-6 text-white pr-1">|</p> <p class="text-sm leading-6 text-white pr-1"> <a class="underline hover:decoration-2 text-white" href="/api-docs">API Documentation</a> </p> <p class="text-sm leading-6 text-white pr-1">|</p> <p class="text-sm leading-6 text-white pr-1"> <a class="underline hover:decoration-2 text-white" href="/help">Help</a> </p> <p class="text-sm leading-6 text-white pr-1">|</p> <p class="text-sm leading-6 text-white pr-1"> <a class="underline hover:decoration-2 text-white" href="/users/sign_in">Login</a> / <a class="underline hover:decoration-2 text-white" href="/users/sign_up">Register</a> </p> </div> </div> <div role="navigation" aria-label="site-navigation" class="relative isolate gap-x-6 overflow-hidden bg-red-600 px-6 py-2.5 sm:px-3.5 sm:before:flex-1"> <div class="flex justify-left "> <div> <a aria-label="Go to IUCN Red List Home" href="/"> <img alt="IUCN Red List brand symbol" src="/assets/brand_symbol-18883460ae737e59c3d24dfc0cabcdf084cc623a2933f4698111859d774048ba.svg" /> </a> </div> <div class='pl-12 flex items-center'> <img alt="The IUCN Red List of Threatened Species™" src="/assets/brand_wordmark-b8db58ffc83da2c6188d91713b747215c019bf0117caf79838d5e82031241a19.svg" /> </div> </div> </div> <main role="main"> <turbo-frame id="modal"></turbo-frame> <div id="content"> <div class="page-species m-12"> <h1 class='font-bold text-4xl p-2'> IUCN Red List API v4 </h1> <h2 class='font-bold text-2xl p-2'>About the IUCN Red List of Threatened Species™</h2> <p class='p-2'> For more information about the IUCN Red List of Threatened Species™, please visit the <a href="https://www.iucnredlist.org/" class="underline" target="_blank">IUCN Red List website</a>. </p> <p class='font-bold text-2xl p-2'>API Usage</p> <p class='p-2'>The use of the API falls under the same Terms of Use as the Red List. By requesting a token, you are agreeing to abide by the <a class='underline' href='https://www.iucnredlist.org/terms/terms-of-use' target="_blank">Terms of Use</a> of the Red List. If your token usage is found to be in breach of our terms of use, it will be revoked.</p> <p class='p-2'>We kindly request your cooperation in ensuring responsible and respectful usage of our services. Please be aware that misusing your API token, such as using it for information extraction (scraping) rather than making legitimate requests for non-commercial purposes, may result in your token being rate limited and/or revoked. We are committed to maintaining a high-quality service for all users and have implemented a rate limiting system to ensure our resources are accessible equally to all. We actively monitor API usage to prevent abuse.</p> <p class='p-2'>We understand that some users may have unique requirements for making frequent calls in succession. If you find yourself in such a situation, we kindly request that you incorporate appropriate delays between your API calls to ensure smooth operation and prevent overloading our system, otherwise your token may be further rate-limited.</p> <p class='p-2'>It's important to note that the Red List API is primarily designed to support conservation efforts, particularly in the fields of education and research. We may need to restrict access if the API is being used for purposes that do not align with our mission, such as mobile app development, inclusion in computing courses, or visualization projects unrelated to conservation.</p> <p class='p-2'><i><strong>Use of the Red List API for commercial purposes is strictly forbidden. Users who wish to use Red List data for commercial purposes should consider subscribing to IBAT (<a href='https://www.ibat-alliance.org' class='underline' target="_blank">www.ibat-alliance.org</a>).</strong></i></p> <p class='p-2'>The underlying data provided via the API is updated every time there is a new version of the Red List. Therefore, if you are going to be using the Red List data from the API frequently between Red List updates, it is recommended that you cache the data within your systems (please check for permissions first by contacting the Red List), and then update your cache whenever there is a new Red List Update.</p> <p class='p-2'>Your cooperation is greatly appreciated as we work together to protect our natural world.</p> <h3 class='font-bold text-xl p-2'>How to cite the IUCN Red List API</h3> <p class='p-2'>Full acknowledgement and citation needs to be given for using the API, which is:</p> <div class="p-4 bg-gray-100 rounded border"> IUCN 2024. IUCN Red List of Threatened Species. Version 2024-2 <www.iucnredlist.org> </div> <h3 class="p-2 font-bold text-xl">Contact</h3> <p class="p-2">If you encounter any problems using the API, or would like to provide feedback of any kind, please contact the Red List team at <el class='underline'>redlist at iucn.org</el>.</p> </div> </div> </main> </div> </body> </html>