{"openapi":"3.1.0","info":{"title":"Meteorites API","version":"1.0.0","description":"NASA's catalogue of 45,000+ meteorites recovered on Earth as an API. For each meteorite: its name, NASA id, classification (recclass, e.g. L5, Iron), mass in grams, whether it was seen to fall or simply found, the year, and the latitude/longitude where it was recovered. Look one up by name or id, find the meteorites NEAR any coordinate (great-circle distance), rank by mass or year, list a classification or year, or search. Great for space, education, mapping and museum apps. Distinct from asteroids and close-approach data — these are rocks already on the ground.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/meteorites-api","description":"oanor gateway"}],"tags":[{"name":"Meteorites"},{"name":"Geo"},{"name":"Rankings"},{"name":"Meta"}],"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/class":{"get":{"operationId":"get_v1_class","tags":["Meteorites"],"summary":"Meteorites of a classification","description":"","parameters":[{"name":"class","in":"query","required":true,"description":"recclass","schema":{"type":"string"},"example":"L5"},{"name":"limit","in":"query","required":false,"description":"Max 1-500","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"class":"l5","count":50,"total":4817,"meteorites":[{"id":"10911","lat":19.22778,"lon":56.14278,"fall":"Found","mass":1750000,"name":"Ghubara","year":1954,"recclass":"L5"},{"id":"24058","lat":48.7,"lon":45.7,"fall":"Found","mass":1225300,"name":"Tsarev","year":1968,"recclass":"L5"},{"id":"10062","lat":35.98333,"lon":-101.9,"fall":"Found","mass":450000,"name":"Etter","year":1965,"recclass":"L5"},{"id":"23193","lat":20.51667,"lon":56.66667,"fall":"Found","mass":450000,"name":"Sayh al Uhaymir 001","year":2000,"recclass":"L5"},{"id":"22609","lat":-39.85,"lon":-69.48333,"fall":"Found","mass":280000,"name":"Rio Limay","year":1995,"recclass":"L5"},{"id":"11901","lat":41.8,"lon":-91.86667,"fall":"Fell","mass":230000,"name":"Homestead","year":1875,"recclass":"L5"},{"id":"5087","lat":29.87861,"lon":-96.87222,"fall":"Found","mass":153300,"name":"Bluff (a)","year":1878,"recclass":"L5"},{"id":"12150","lat":19.69362,"lon":56.65432,"fall":"Found","mass":123374,"name":"Jiddat al Harasis 091","year":2002,"recclass":"L5"},{"id":"16804","lat":18.7,"lon":4.8,"fall":"Fell","mass":110000,"name":"Mount Tazerzait","year":1991,"recclass":"L5"},{"id":"23509","lat":50.61667,"lon":36.6,"fall":"Fell","mass":101000,"name":"Sevrukovo","year":1874,"recclass":"L5"},{"id":"12149","lat":19.71678,"lon":56.6062,"fall":"Found","mass":92667.6,"name":"Jiddat al Harasis 090","year":2002,"recclass":"L5"},{"id":"10074","lat":39.75,"lon":-97.03333,"fall":"Fell","mass":89400,"name":"Farmington","year":1890,"recclass":"L5"},{"id":"53763","fall":"Found","mass":88000,"name":"Northwest Africa 6727","year":2006,"recclass":"L5"},{"id":"11201","lat":39.93333,"lon":-99.21667,"fall":"Found","mass":82000,"name":"Gretna","year":1912,"recclass":"L5"},{"id":"35549","lat":19.7127,"lon":56.58277,"fall":"Found","mass":77000,"name":"Jiddat al Harasis 230","year":2005,"recclass":"L5"},{"id":"4978","lat":41.81667,"lon":-103.36667,"fall":"Found","mass":75000,"name":"Bayard","year":1982,"recclass":"L5"},{"id":"23588","lat":-40.8,"lon":-67.48333,"fall":"Found","mass":71300,"name":"Sierra Colorada","year":1995,"recclass":"L5"},{"id":"24335","lat":-25.65,"lon":114.21667,"fall":"Found","mass":71000,"name":"Wooramel","year":1969,"recclass":"L5"},{"id":"15428","lat":34.6,"lon":-97.91667,"fall":"Found","mass":68000,"name":"Marlow","year":1936,"recclass":"L5"},{"id":"31302","lat":28.225,"lon":70.2,"fall":"Fell","mass":67225,"name":"Rahimyar Khan","year":1983,"recclass":"L5"},{"id":"52413","lat":-38.85028,"lon":-62.87889,"fall":"Found","mass":60000,"name":"Nicolás Levalle","year":1956,"recclass":"L5"},{"id":"7824","lat":47.83333,"lon":37.66667,"fall":"Fell","mass":54640,"name":"Elenovka","year":1951,"recclass":"L5"},{"id":"31146","fall":"Found","mass":53822,"name":"Northwest Africa 2740","recclass":"L5"},{"id":"4903","lat":43.08333,"lon":0.58333,"fall":"Fell","mass":50000,"name":"Ausson","year":1858,"recclass":"L5"},{"id":"24149","lat":9.31667,"lon":-70.62833,"fall":"Fell","mass":50000,"name":"Valera","year":1972,"recclass":"L5"},{"id":"55572","lat":18.67877,"lon":54.2876,"fall":"Found","mass":50000,"name":"Dhofar 1654","year":2011,"recclass":"L5"},{"id":"45866","lat":19.71458,"lon":56.54755,"fall":"Found","mass":49750,"name":"Jiddat al Harasis 342","year":2006,"recclass":"L5"},{"id":"22774","lat":35.95,"lon":-104.2,"fall":"Found","mass":47200,"name":"Roy (1933)","year":1933,"recclass":"L5"},{"id":"4995","lat":36.21667,"lon":-103.65,"fall":"Found","mass":44400,"name":"Beenham","year":1937,"recclass":"L5"},{"id":"4954","lat":52.56528,"lon":-1.33972,"fall":"Fell","mass":44000,"name":"Barwell","year":1965,"recclass":"L5"},{"id":"52563","fall":"Found","mass":43000,"name":"Northwest Africa 6411","year":2006,"recclass":"L5"},{"id":"15475","lat":34.38333,"lon":-103.61667,"fall":"Found","mass":36400,"name":"Melrose (a)","year":1933,"recclass":"L5"},{"id":"11849","lat":33.21333,"lon":-99.73167,"fall":"Found","mass":36000,"name":"Haskell","year":1909,"recclass":"L5"},{"id":"2339","lat":39.3,"lon":-103.25,"fall":"Found","mass":31100,"name":"Arriba","year":1936,"recclass":"L5"},{"id":"12400","lat":34.45,"lon":-104.13333,"fall":"Found","mass":30000,"name":"La Lande","year":1933,"recclass":"L5"},{"id":"32639","fall":"Found","mass":29000,"name":"Grosvenor Mountains 03001","year":2002,"recclass":"L5"},{"id":"32640","fall":"Found","mass":28000,"name":"Grosvenor Mountains 03002","year":2002,"recclass":"L5"},{"id":"23451","lat":21.26172,"lon":57.17887,"fall":"Found","mass":27860.8,"name":"Sayh al Uhaymir 278","year":2002,"recclass":"L5"},{"id":"12226","lat":34.67167,"lon":-101.815,"fall":"Found","mass":26760,"name":"Kaffir (d)","year":1981,"recclass":"L5"},{"id":"10122","lat":33.49556,"lon":-97.58861,"fall":"Found","mass":26600,"name":"Forestburg (b)","year":1957,"recclass":"L5"},{"id":"17893","fall":"Found","mass":26399,"name":"Northwest Africa 904","year":2001,"recclass":"L5"},{"id":"12013","lat":21.6,"lon":1.66667,"fall":"Found","mass":26100,"name":"Ilafegh 008","year":1989,"recclass":"L5"},{"id":"4985","lat":36.8,"lon":-100.53333,"fall":"Found","mass":25628,"name":"Beaver","year":1940,"recclass":"L5"},{"id":"10960","lat":-86.71667,"lon":-141.5,"fall":"Found","mass":25066.1,"name":"Graves Nunataks 95200","year":1995,"recclass":"L5"},{"id":"23785","lat":34.45,"lon":-104.01667,"fall":"Found","mass":25000,"name":"Taiban","year":1934,"recclass":"L5"},{"id":"5249","lat":-7.03333,"lon":-40.16667,"fall":"Fell","mass":23680,"name":"Campos Sales","year":1991,"recclass":"L5"},{"id":"12267","lat":32.58333,"lon":-96.41667,"fall":"Found","mass":23000,"name":"Kaufman","year":1893,"recclass":"L5"},{"id":"52412","lat":31.47556,"lon":113.56694,"fall":"Fell","mass":23000,"name":"Fuhe","year":1945,"recclass":"L5"},{"id":"10184","lat":34.54,"lon":-102.56833,"fall":"Found","mass":21900,"name":"Friona","year":1981,"recclass":"L5"},{"id":"12432","lat":36.38333,"lon":-98.08333,"fall":"Found","mass":21800,"name":"Lahoma","year":1963,"recclass":"L5"}]},"meta":{"timestamp":"2026-06-09T03:03:49.257Z","request_id":"ecfe0b12-c09f-474b-8aaa-00bf217b7a8f"},"status":"ok","message":"Class retrieved successfully","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/meteorite":{"get":{"operationId":"get_v1_meteorite","tags":["Meteorites"],"summary":"Meteorite by name or id","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Meteorite name (preferred)","schema":{"type":"string"},"example":"Hoba"},{"name":"id","in":"query","required":false,"description":"NASA id","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"meteorite":{"id":"11890","lat":-19.58333,"lon":17.91667,"fall":"Found","mass":60000000,"name":"Hoba","year":1920,"recclass":"Iron, IVB"}},"meta":{"timestamp":"2026-06-09T03:03:49.340Z","request_id":"58a3011e-d52f-432f-94a2-09596f936b81"},"status":"ok","message":"Meteorite retrieved successfully","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":["Meteorites"],"summary":"Search meteorites by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"allende"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"allende","total":1,"meteorites":[{"id":"2278","lat":26.96667,"lon":-105.31667,"fall":"Fell","mass":2000000,"name":"Allende","year":1969,"recclass":"CV3"}]},"meta":{"timestamp":"2026-06-09T03:03:49.434Z","request_id":"f7611feb-6474-49cd-b43d-9edd8bc30dc6"},"status":"ok","message":"Search results retrieved successfully","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/year":{"get":{"operationId":"get_v1_year","tags":["Meteorites"],"summary":"Meteorites recovered in a year","description":"","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"string"},"example":"1947"},{"name":"limit","in":"query","required":false,"description":"Max 1-500","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"year":1947,"count":19,"total":19,"meteorites":[{"id":"23593","lat":46.16,"lon":134.65333,"fall":"Fell","mass":23000000,"name":"Sikhote-Alin","year":1947,"recclass":"Iron, IIAB"},{"id":"24326","lat":-19.3,"lon":127.76667,"fall":"Found","mass":760000,"name":"Wolf Creek","year":1947,"recclass":"Iron, IIIAB"},{"id":"371","lat":33.63333,"lon":-104.26667,"fall":"Found","mass":75000,"name":"Acme","year":1947,"recclass":"H5"},{"id":"11840","lat":35.95,"lon":-84.56667,"fall":"Found","mass":30000,"name":"Harriman (Of)","year":1947,"recclass":"Iron, IVA"},{"id":"5289","lat":-22.46667,"lon":-42.21667,"fall":"Found","mass":25000,"name":"Casimiro de Abreu","year":1947,"recclass":"Iron, IIIAB"},{"id":"22584","lat":42.475,"lon":-5.33333,"fall":"Fell","mass":17300,"name":"Reliegos","year":1947,"recclass":"L5"},{"id":"11886","lat":39.36667,"lon":-99.85,"fall":"Found","mass":11700,"name":"Hill City","year":1947,"recclass":"Iron, IVA"},{"id":"7760","lat":40.78167,"lon":-96.47167,"fall":"Fell","mass":10000,"name":"Eagle","year":1947,"recclass":"EL6"},{"id":"12234","lat":44.64694,"lon":-85.13667,"fall":"Found","mass":9399,"name":"Kalkaska","year":1947,"recclass":"Iron, IIIAB"},{"id":"2293","lat":40.8,"lon":-99.2,"fall":"Found","mass":8500,"name":"Amherst","year":1947,"recclass":"L6"},{"id":"18866","lat":31.66333,"lon":-99.95,"fall":"Found","mass":4642,"name":"Pony Creek","year":1947,"recclass":"H4"},{"id":"18788","lat":39.35,"lon":-99.91667,"fall":"Found","mass":3580,"name":"Penokee","year":1947,"recclass":"H5"},{"id":"12461","lat":58.85,"lon":16.73333,"fall":"Fell","mass":2300,"name":"Långhalsen","year":1947,"recclass":"L6"},{"id":"14720","fall":"Found","mass":2077,"name":"Loyola","year":1947,"recclass":"L5"},{"id":"23134","lat":40.81667,"lon":-102.25,"fall":"Found","mass":1200,"name":"Sand Draw","year":1947,"recclass":"H5"},{"id":"10919","lat":9.6,"lon":9.91667,"fall":"Fell","mass":480,"name":"Git-Git","year":1947,"recclass":"L6"},{"id":"23683","fall":"Found","mass":266,"name":"Southern Arizona","year":1947,"recclass":"Iron, IAB-sLL"},{"id":"18823","lat":32.2,"lon":-111,"fall":"Found","mass":210,"name":"Pima County","year":1947,"recclass":"Iron, IIAB"},{"id":"23483","lat":22.83333,"lon":4.98333,"fall":"Fell","mass":150,"name":"Seldebourak","year":1947,"recclass":"H5"}]},"meta":{"timestamp":"2026-06-09T03:03:49.524Z","request_id":"c0934d57-6ee3-41be-b78d-ddfd08dc80d8"},"status":"ok","message":"Meteorites by year retrieved successfully","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/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Geo"],"summary":"Meteorites near a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"},"example":"-19.58"},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"string"},"example":"17.91"},{"name":"radius_km","in":"query","required":false,"description":"Radius km (default 500)","schema":{"type":"string"},"example":"300"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"total":4,"origin":{"lat":-19.58,"lon":17.91},"radius_km":300,"meteorites":[{"id":"11890","lat":-19.58333,"lon":17.91667,"fall":"Found","mass":60000000,"name":"Hoba","year":1920,"recclass":"Iron, IVB","distance_km":0.8},{"id":"10061","lat":-18.5,"lon":16,"fall":"Found","mass":110700,"name":"Etosha","year":1970,"recclass":"Iron, IC","distance_km":233.9},{"id":"18055","lat":-18,"lon":16,"fall":"Fell","mass":121.5,"name":"Ovambo","year":1900,"recclass":"L6","distance_km":267},{"id":"17999","lat":-21.98333,"lon":16.93333,"fall":"Found","mass":6580,"name":"Okahandja","year":1926,"recclass":"Iron, IIAB","distance_km":285.9}]},"meta":{"timestamp":"2026-06-09T03:03:49.648Z","request_id":"80ccb45c-01a7-4751-9199-943b34365384"},"status":"ok","message":"Nearby meteorites retrieved successfully","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/rank":{"get":{"operationId":"get_v1_rank","tags":["Rankings"],"summary":"Rank meteorites by metric","description":"","parameters":[{"name":"by","in":"query","required":false,"description":"mass | year","schema":{"type":"string"},"example":"mass"},{"name":"order","in":"query","required":false,"description":"desc or asc","schema":{"type":"string"},"example":"desc"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"order":"desc","metric":"mass","ranking":[{"id":"11890","lat":-19.58333,"lon":17.91667,"fall":"Found","mass":60000000,"name":"Hoba","year":1920,"value":60000000,"position":1,"recclass":"Iron, IVB"},{"id":"5262","lat":76.13333,"lon":-64.93333,"fall":"Found","mass":58200000,"name":"Cape York","year":1818,"value":58200000,"position":2,"recclass":"Iron, IIIAB"},{"id":"5247","lat":-27.46667,"lon":-60.58333,"fall":"Found","mass":50000000,"name":"Campo del Cielo","year":1575,"value":50000000,"position":3,"recclass":"Iron, IAB-MG"},{"id":"5257","lat":35.05,"lon":-111.03333,"fall":"Found","mass":30000000,"name":"Canyon Diablo","year":1891,"value":30000000,"position":4,"recclass":"Iron, IAB-MG"},{"id":"2335","lat":47,"lon":88,"fall":"Found","mass":28000000,"name":"Armanty","year":1898,"value":28000000,"position":5,"recclass":"Iron, IIIE"},{"id":"10912","lat":-25.5,"lon":18,"fall":"Found","mass":26000000,"name":"Gibeon","year":1836,"value":26000000,"position":6,"recclass":"Iron, IVA"},{"id":"5363","lat":27,"lon":-105.1,"fall":"Found","mass":24300000,"name":"Chupaderos","year":1852,"value":24300000,"position":7,"recclass":"Iron, IIIAB"},{"id":"16852","lat":-30.78333,"lon":127.55,"fall":"Found","mass":24000000,"name":"Mundrabilla","year":1911,"value":24000000,"position":8,"recclass":"Iron, IAB-ung"},{"id":"23593","lat":46.16,"lon":134.65333,"fall":"Fell","mass":23000000,"name":"Sikhote-Alin","year":1947,"value":23000000,"position":9,"recclass":"Iron, IIAB"},{"id":"4919","lat":26.2,"lon":-107.83333,"fall":"Found","mass":22000000,"name":"Bacubirito","year":1863,"value":22000000,"position":10,"recclass":"Iron, ungrouped"}]},"meta":{"timestamp":"2026-06-09T03:03:49.845Z","request_id":"dc6db5c8-baf5-4450-b39b-5ec71b0ffb74"},"status":"ok","message":"Ranking retrieved successfully","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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fell":1107,"found":44609,"service":"meteorites-api","geocoded":32186,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rank":"Rank by mass or year (by=mass|year, order, limit).","GET /v1/year":"Meteorites recovered in a year (year=, e.g. 1947).","GET /v1/class":"Meteorites of a classification (class=, e.g. L5), heaviest first.","GET /v1/nearby":"Meteorites within radius_km of lat=/lon= (great-circle, nearest first).","GET /v1/search":"Search meteorites by name (q=).","GET /v1/meteorite":"Meteorite by name (name=, e.g. Hoba) or NASA id (id=)."},"year_range":[601,2013],"description":"NASA catalogue of 45,000+ meteorites recovered on Earth: name, id, classification, mass, fell/found, year and recovery coordinates. Look up by name or id, find meteorites near a coordinate (haversine), rank by mass or year, list a class or year, or search. Distinct from asteroids-api and closeapproach-api. No key.","distinct_classes":454,"rankable_metrics":["mass","year"],"total_meteorites":45716},"meta":{"timestamp":"2026-06-09T03:03:49.923Z","request_id":"449435e3-153f-4a00-8ad0-cbead3d904cf"},"status":"ok","message":"Meta","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":500,"rps_limit":5,"hard_limit":true},{"slug":"hobby","name":"Hobby","price_cents_month":600,"monthly_call_quota":20000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1700,"monthly_call_quota":100000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4100,"monthly_call_quota":500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/meteorites-api"}