{"openapi":"3.1.0","info":{"title":"Satellites API","version":"1.0.0","description":"The CelesTrak satellite catalogue (SATCAT) as an API — 33,000+ catalogued payloads and rocket bodies in (and decayed from) Earth orbit. Look up any object by its NORAD catalogue number (e.g. 25544 → ISS (ZARYA)) or international designator (e.g. 1998-067A); search by name with filters for owner/country, object type and in-orbit status; or list every operator with object counts. Each record carries the operational status, launch date and site, decay status, and orbit (period, inclination, apogee/perigee). Ideal for space dashboards, satellite trackers, OSINT and educational tools. (Catalogued averages, not live ephemeris/TLE.)","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/satellites-api","description":"oanor gateway"}],"tags":[{"name":"Satellites"},{"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/owners":{"get":{"operationId":"get_v1_owners","tags":["Satellites"],"summary":"Operators / countries with object counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":129,"owners":[{"count":18386,"owner":"US","owner_name":"United States"},{"count":7912,"owner":"CIS","owner_name":"Russia / CIS"},{"count":2501,"owner":"PRC","owner_name":"China"},{"count":755,"owner":"UK","owner_name":"United Kingdom"},{"count":512,"owner":"JPN","owner_name":"Japan"},{"count":415,"owner":"FR","owner_name":"France"},{"count":240,"owner":"IND","owner_name":"India"},{"count":209,"owner":"TBD","owner_name":"Unallocated"},{"count":143,"owner":"GER","owner_name":"Germany"},{"count":141,"owner":"IT","owner_name":"Italy"},{"count":139,"owner":"ESA","owner_name":"European Space Agency"},{"count":110,"owner":"CA","owner_name":"Canada"},{"count":101,"owner":"ITSO","owner_name":"Intelsat"},{"count":101,"owner":"SPN","owner_name":"Spain"},{"count":84,"owner":"GLOB","owner_name":"Globalstar"},{"count":83,"owner":"SKOR","owner_name":"South Korea"},{"count":72,"owner":"AUS","owner_name":"Australia"},{"count":72,"owner":"ARGN","owner_name":"Argentina"},{"count":69,"owner":"SES","owner_name":"SES"},{"count":67,"owner":"ISRA","owner_name":"Israel"},{"count":62,"owner":"EUTE","owner_name":"Eutelsat"},{"count":60,"owner":"ORB","owner_name":"ORBCOMM"},{"count":52,"owner":"TURK","owner_name":"Turkey"},{"count":45,"owner":"ROC","owner_name":"Taiwan"},{"count":45,"owner":"FIN","owner_name":"Finland"},{"count":34,"owner":"SEAL"},{"count":32,"owner":"BRAZ","owner_name":"Brazil"},{"count":32,"owner":"UAE","owner_name":"United Arab Emirates"},{"count":30,"owner":"IRAN","owner_name":"Iran"},{"count":30,"owner":"O3B"},{"count":29,"owner":"NOR","owner_name":"Norway"},{"count":27,"owner":"SING"},{"count":27,"owner":"POL","owner_name":"Poland"},{"count":25,"owner":"LUXE","owner_name":"Luxembourg"},{"count":25,"owner":"NZ"},{"count":23,"owner":"INDO","owner_name":"Indonesia"},{"count":22,"owner":"SWTZ","owner_name":"Switzerland"},{"count":20,"owner":"IM"},{"count":19,"owner":"SAUD","owner_name":"Saudi Arabia"},{"count":18,"owner":"AB"},{"count":18,"owner":"DEN","owner_name":"Denmark"},{"count":17,"owner":"BEL","owner_name":"Belgium"},{"count":16,"owner":"NETH","owner_name":"Netherlands"},{"count":16,"owner":"THAI","owner_name":"Thailand"},{"count":15,"owner":"CZCH"},{"count":15,"owner":"GREC"},{"count":15,"owner":"EGYP","owner_name":"Egypt"},{"count":14,"owner":"SWED","owner_name":"Sweden"},{"count":14,"owner":"MALA"},{"count":13,"owner":"MEX","owner_name":"Mexico"},{"count":13,"owner":"PAKI","owner_name":"Pakistan"},{"count":13,"owner":"LTU"},{"count":13,"owner":"RWA"},{"count":12,"owner":"EUME"},{"count":11,"owner":"SAFR","owner_name":"South Africa"},{"count":11,"owner":"HUN"},{"count":10,"owner":"RP","owner_name":"Philippines"},{"count":10,"owner":"UKR"},{"count":9,"owner":"KAZ"},{"count":8,"owner":"NATO","owner_name":"NATO"},{"count":8,"owner":"AC"},{"count":8,"owner":"ABS"},{"count":8,"owner":"ALG"},{"count":8,"owner":"BUL"},{"count":7,"owner":"ESRO","owner_name":"ESRO"},{"count":7,"owner":"POR"},{"count":7,"owner":"CHLE"},{"count":7,"owner":"VTNM"},{"count":6,"owner":"ISS","owner_name":"ISS (international)"},{"count":6,"owner":"NIG"},{"count":6,"owner":"NKOR"},{"count":5,"owner":"CHBZ"},{"count":5,"owner":"BELA"},{"count":4,"owner":"AZER"},{"count":4,"owner":"ASRA"},{"count":4,"owner":"PERU"},{"count":4,"owner":"MA"},{"count":3,"owner":"COL"},{"count":3,"owner":"VENZ","owner_name":"Venezuela"},{"count":3,"owner":"SVK"},{"count":3,"owner":"SVN"},{"count":3,"owner":"KWT"},{"count":2,"owner":"FGER"},{"count":2,"owner":"STCT"},{"count":2,"owner":"RASC"},{"count":2,"owner":"ROM"},{"count":2,"owner":"ECU"},{"count":2,"owner":"EST"},{"count":2,"owner":"FRIT"},{"count":2,"owner":"SGJP"},{"count":2,"owner":"BGD"},{"count":2,"owner":"ANG"},{"count":2,"owner":"KEN"},{"count":2,"owner":"ZWE"},{"count":2,"owner":"DJI"},{"count":1,"owner":"NICO"},{"count":1,"owner":"USBZ"},{"count":1,"owner":"BOL"},{"count":1,"owner":"URY"},{"count":1,"owner":"IRAQ"},{"count":1,"owner":"TMMC"},{"count":1,"owner":"LAOS"},{"count":1,"owner":"GHA"},{"count":1,"owner":"MNG"},{"count":1,"owner":"CRI"},{"count":1,"owner":"BHUT"},{"count":1,"owner":"JOR"},{"count":1,"owner":"GRSA"},{"count":1,"owner":"LKA"},{"count":1,"owner":"NPL"},{"count":1,"owner":"SDN"},{"count":1,"owner":"ETH"},{"count":1,"owner":"GUAT"},{"count":1,"owner":"PRY"},{"count":1,"owner":"TUN"},{"count":1,"owner":"MMR"},{"count":1,"owner":"MUS"},{"count":1,"owner":"MDA"},{"count":1,"owner":"UGA"},{"count":1,"owner":"MCO"},{"count":1,"owner":"VAT"},{"count":1,"owner":"ARM"},{"count":1,"owner":"IRL"},{"count":1,"owner":"SEN"},{"count":1,"owner":"HRV"},{"count":1,"owner":"BWA"},{"count":1,"owner":"BHR"},{"count":1,"owner":"SLB"},{"count":1,"owner":"MNE"}]},"meta":{"timestamp":"2026-05-31T03:28:31.472Z","request_id":"a9005b56-b4d2-45e6-9126-f39995243ed6"},"status":"ok","message":"Owners listed","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/satellite":{"get":{"operationId":"get_v1_satellite","tags":["Satellites"],"summary":"A single catalogued object by NORAD number or designator","description":"","parameters":[{"name":"norad","in":"query","required":false,"description":"NORAD catalogue number, e.g. 25544 (ISS)","schema":{"type":"string"},"example":"25544"},{"name":"designator","in":"query","required":false,"description":"International designator, e.g. 1998-067A","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"ISS (ZARYA)","type":"payload","orbit":{"apogee_km":423,"perigee_km":413,"period_min":92.93,"inclination_deg":51.63},"owner":"ISS","status":"operational","in_orbit":true,"norad_id":25544,"owner_name":"ISS (international)","launch_date":"1998-11-20","launch_site":"TYMSC","intl_designator":"1998-067A"},"meta":{"timestamp":"2026-05-31T03:28:31.546Z","request_id":"f109d1e8-fcd9-4d0e-98d6-b4f15e52e5d8"},"status":"ok","message":"Satellite 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/search":{"get":{"operationId":"get_v1_search","tags":["Satellites"],"summary":"Search by name with owner / type / orbit filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name search, e.g. starlink","schema":{"type":"string"},"example":"hubble"},{"name":"owner","in":"query","required":false,"description":"Owner / country code, e.g. US, CIS, PRC, ESA","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"payload | rocket-body","schema":{"type":"string"}},{"name":"in_orbit","in":"query","required":false,"description":"true = still in orbit, false = decayed","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"limit":20,"query":"hubble","total":4,"offset":0,"filters":[],"results":[{"name":"HUBBLE 6","type":"payload","orbit":{"apogee_km":587,"perigee_km":585,"period_min":96.4,"inclination_deg":97.77},"owner":"US","status":"operational","in_orbit":true,"norad_id":64562,"owner_name":"United States","launch_date":"2025-06-23","launch_site":"AFWTR","intl_designator":"2025-135AL"},{"name":"LEMUR-2-HUBBLE-4","type":"payload","orbit":{"apogee_km":590,"perigee_km":586,"period_min":96.44,"inclination_deg":97.77},"owner":"US","status":"operational","in_orbit":true,"norad_id":64565,"owner_name":"United States","launch_date":"2025-06-23","launch_site":"AFWTR","intl_designator":"2025-135AP"},{"name":"HUBBLE 7","type":"payload","orbit":{"apogee_km":589,"perigee_km":583,"period_min":96.4,"inclination_deg":97.77},"owner":"US","status":"operational","in_orbit":true,"norad_id":64592,"owner_name":"United States","launch_date":"2025-06-23","launch_site":"AFWTR","intl_designator":"2025-135BS"},{"name":"LEMUR-2-HUBBLE-5","type":"payload","orbit":{"apogee_km":590,"perigee_km":581,"period_min":96.38,"inclination_deg":97.77},"owner":"US","status":"operational","in_orbit":true,"norad_id":64840,"owner_name":"United States","launch_date":"2025-06-23","launch_site":"AFWTR","intl_designator":"2025-135BT"}]},"meta":{"timestamp":"2026-05-31T03:28:31.621Z","request_id":"c18b97f3-8cf0-4941-ac22-b4e5c178f974"},"status":"ok","message":"Satellites listed","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":"Totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Catalogued payloads and rocket bodies; debris excluded. Orbit values are catalogued averages, not live ephemeris.","total":33211,"fields":["norad_id","name","intl_designator","type","status","owner","launch_date","launch_site","decay_date","in_orbit","orbit"],"owners":129,"source":"CelesTrak SATCAT (payloads + rocket bodies)","decayed":11823,"in_orbit":21388,"payloads":26363,"rocket_bodies":6848},"meta":{"timestamp":"2026-05-31T03:28:31.706Z","request_id":"47f0af58-4aac-4e5c-8dd0-a89836db2920"},"status":"ok","message":"Meta 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":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":50000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5000,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/satellites-api"}