{"openapi":"3.1.0","info":{"title":"Biodiversity API","version":"1.0.0","description":"Match scientific or common species names to the GBIF taxonomic backbone (kingdom to species), search the global species catalogue, fetch full taxon records with vernacular names, and retrieve geo-located occurrence observations. Ideal for nature, education, research, conservation and citizen-science apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/biodiversity-api","description":"oanor gateway"}],"tags":[{"name":"Species"},{"name":"Occurrences"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/match":{"get":{"operationId":"get_v1_match","tags":["Species"],"summary":"Match a name to taxonomy","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Scientific or common name","schema":{"type":"string"},"example":"Panthera leo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"rank":"SPECIES","class":"Mammalia","genus":"Panthera","order":"Carnivora","family":"Felidae","phylum":"Chordata","status":"ACCEPTED","kingdom":"Animalia","matched":true,"species":"Panthera leo","usage_key":5219404,"confidence":99,"match_type":"EXACT","canonical_name":"Panthera leo","scientific_name":"Panthera leo (Linnaeus, 1758)"},"meta":{"timestamp":"2026-05-30T05:06:20.736Z","request_id":"a3ec1652-d77b-4557-af0b-938abf6af9e1"},"status":"ok","message":"Name matched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Species"],"summary":"Search the species backbone","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"oak"},{"name":"limit","in":"query","required":false,"description":"Max 1-25","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"oak","total":14832,"results":[{"key":167121945,"class":"Monjiviricetes","genus":"Sunrhavirus","order":"Mononegavirales","family":"Rhabdoviridae","phylum":"Negarnaviricota","status":"SYNONYM","kingdom":"Orthornavirae","species":"Sunrhavirus oakvale","scientific_name":"Oak Vale virus"},{"key":304906672,"rank":"SPECIES","class":"Alsuviricetes","genus":"Blunervirus","order":"Martellivirales","family":"Kitaviridae","phylum":"Kitrinoviricota","status":"ACCEPTED","kingdom":"Orthornavirae","species":"Oak blunervirus 1","scientific_name":"Oak blunervirus 1"},{"key":179903309,"rank":"SPECIES","class":"Naldaviricetes","genus":"Alphabaculovirus","order":"Lefavirales","family":"Baculoviridae","status":"ACCEPTED","species":"Oak looper alphabaculovirus","scientific_name":"Oak looper alphabaculovirus"},{"key":219592263,"rank":"UNRANKED","class":"Monjiviricetes","genus":"Alphacytorhabdovirus","order":"Mononegavirales","family":"Rhabdoviridae","phylum":"Negarnaviricota","status":"ACCEPTED","kingdom":"Orthornavirae","species":"Alphacytorhabdovirus querci","scientific_name":"Oak alphacytorhabdovirus 1"},{"key":102475028,"rank":"SPECIES","class":"Naldaviricetes","genus":"Alphabaculovirus","order":"Lefavirales","family":"Baculoviridae","status":"ACCEPTED","species":"Oak looper alphabaculovirus","scientific_name":"Oak looper alphabaculovirus"},{"key":179875929,"class":"Monjiviricetes","genus":"Sunrhavirus","order":"Mononegavirales","family":"Rhabdoviridae","phylum":"Negarnaviricota","status":"ACCEPTED","kingdom":"Orthornavirae","species":"Sunrhavirus oakvale","scientific_name":"Oak-Vale virus"},{"key":102327128,"rank":"UNRANKED","class":"Monjiviricetes","genus":"Sunrhavirus","order":"Mononegavirales","family":"Rhabdoviridae","phylum":"Negarnaviricota","status":"ACCEPTED","kingdom":"Orthornavirae","species":"Sunrhavirus oakvale","scientific_name":"Oak-Vale virus"},{"key":177415262,"rank":"SPECIES","class":"Alsuviricetes","order":"Tymovirales","family":"Betaflexiviridae","phylum":"Kitrinoviricota","status":"ACCEPTED","kingdom":"Orthornavirae","species":"Oak betaflexivirus 1","scientific_name":"Oak betaflexivirus 1"},{"key":217777678,"rank":"SPECIES","class":"Monjiviricetes","order":"Mononegavirales","family":"Rhabdoviridae","phylum":"Negarnaviricota","status":"ACCEPTED","kingdom":"Orthornavirae","species":"Oak alphacytorhabdovirus 1","scientific_name":"Oak alphacytorhabdovirus 1"},{"key":177627974,"rank":"SPECIES","genus":"Pythium","order":"Pythiales","family":"Pythiaceae","phylum":"Oomycota","status":"ACCEPTED","species":"Pythium sp.Oak","canonical_name":"Pythium sp.Oak","scientific_name":"Pythium sp. OAK"}]},"meta":{"timestamp":"2026-05-30T05:06:21.178Z","request_id":"9820c3a9-3c3f-4730-8c84-a197cadb02a2"},"status":"ok","message":"Species search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/species":{"get":{"operationId":"get_v1_species","tags":["Species"],"summary":"Taxon record by key","description":"","parameters":[{"name":"key","in":"query","required":true,"description":"Numeric taxon key","schema":{"type":"string"},"example":"5219404"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"key":5219404,"rank":"SPECIES","class":"Mammalia","genus":"Panthera","order":"Carnivora","family":"Felidae","phylum":"Chordata","status":"ACCEPTED","kingdom":"Animalia","species":"Panthera leo","authorship":"(Linnaeus, 1758) ","canonical_name":"Panthera leo","scientific_name":"Panthera leo (Linnaeus, 1758)","vernacular_name":"African lion"},"meta":{"timestamp":"2026-05-30T05:06:21.616Z","request_id":"dd9ce56a-0dc6-4099-a839-1b6fec35cd7a"},"status":"ok","message":"Species retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/occurrences":{"get":{"operationId":"get_v1_occurrences","tags":["Occurrences"],"summary":"Occurrence observations","description":"","parameters":[{"name":"taxon_key","in":"query","required":true,"description":"Numeric taxon key","schema":{"type":"string"},"example":"5219404"},{"name":"limit","in":"query","required":false,"description":"Max 1-25","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"total":18533,"results":[{"day":1,"key":5938104699,"year":2026,"month":1,"country":"South Africa","dataset":"iNaturalist research-grade observations","latitude":-24.907649,"longitude":31.462346,"country_code":"ZA","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":3,"key":5938252120,"year":2026,"month":1,"country":"South Africa","dataset":"iNaturalist research-grade observations","latitude":-32.35723,"longitude":25.563539,"country_code":"ZA","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":1,"key":5938302574,"year":2026,"month":1,"country":"Tanzania, United Republic of","dataset":"iNaturalist research-grade observations","latitude":-3.196291,"longitude":35.612309,"country_code":"TZ","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":2,"key":5938306747,"year":2026,"month":1,"country":"South Africa","dataset":"iNaturalist research-grade observations","latitude":-24.981695,"longitude":31.437652,"country_code":"ZA","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":3,"key":5938326058,"year":2026,"month":1,"country":"Tanzania, United Republic of","dataset":"iNaturalist research-grade observations","latitude":-3.821211,"longitude":36.081052,"country_code":"TZ","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":3,"key":5938341495,"year":2026,"month":1,"country":"Tanzania, United Republic of","dataset":"iNaturalist research-grade observations","latitude":-3.087878,"longitude":35.764644,"country_code":"TZ","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":1,"key":5938346854,"year":2026,"month":1,"country":"South Africa","dataset":"iNaturalist research-grade observations","latitude":-24.802694,"longitude":31.581901,"country_code":"ZA","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":5,"key":5938378320,"year":2026,"month":1,"country":"South Africa","dataset":"iNaturalist research-grade observations","latitude":-24.615243,"longitude":31.960007,"country_code":"ZA","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":1,"key":5938557641,"year":2026,"month":1,"country":"South Africa","dataset":"iNaturalist research-grade observations","latitude":-24.693746,"longitude":31.548705,"country_code":"ZA","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"},{"day":3,"key":5938580667,"year":2026,"month":1,"country":"Tanzania, United Republic of","dataset":"iNaturalist research-grade observations","latitude":-3.136021,"longitude":35.731679,"country_code":"TZ","basis_of_record":"HUMAN_OBSERVATION","scientific_name":"Panthera leo melanochaita (C.E.H.Smith, 1858)"}],"taxon_key":5219404},"meta":{"timestamp":"2026-05-30T05:06:22.543Z","request_id":"74b154a0-4901-42f6-945b-84742cb313c9"},"status":"ok","message":"Occurrences retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":80000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":450000,"rps_limit":18,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":2000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/biodiversity-api"}