{"openapi":"3.1.0","info":{"title":"Deep-Sky Objects API","version":"1.0.0","description":"The OpenNGC (NGC/IC) catalogue of deep-sky objects as an API — 13,000+ galaxies, nebulae and star clusters. Look up any object by its catalogue name (NGC224, IC434), Messier number (M31 → Andromeda Galaxy, M42 → Orion Nebula, M1 → Crab Nebula) or common name; browse the full 110-object Messier catalogue; or search by type (galaxy, planetary nebula, globular cluster…) and constellation. Each record carries the object type, J2000 coordinates (sexagesimal + decimal), V/B magnitude, angular size, surface brightness, Hubble morphological type, constellation and cross-catalogue identifiers. Ideal for astronomy apps, telescope planners, planetarium software and education.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/deepsky-api","description":"oanor gateway"}],"tags":[{"name":"Deep-Sky"},{"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/messier":{"get":{"operationId":"get_v1_messier","tags":["Deep-Sky"],"summary":"A Messier object, or the full Messier catalogue","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"Messier number 1-110 (omit to list all)","schema":{"type":"string"},"example":"31"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ra":"00:42:44.35","dec":"+41:16:08.6","name":"NGC0224","type":"G","b_mag":4.29,"v_mag":3.44,"ra_deg":10.68479,"dec_deg":41.26906,"messier":"M31","type_name":"Galaxy","common_name":"Andromeda Galaxy","hubble_type":"Sb","identifiers":"2MASX J00424433+4116074,IRAS 00400+4059,MCG +07-02-016,PGC 002557,UGC 00454","constellation":"And","messier_number":31,"major_axis_arcmin":177.83,"minor_axis_arcmin":69.66,"constellation_name":"Andromeda","surface_brightness":23.63},"meta":{"timestamp":"2026-05-31T05:48:02.658Z","request_id":"84b09cdc-d0d0-494c-b8ad-0e577bcbd82f"},"status":"ok","message":"Messier object 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/object":{"get":{"operationId":"get_v1_object","tags":["Deep-Sky"],"summary":"An object by catalogue name, Messier number or common name","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Catalogue name (NGC224), M31 or a common name","schema":{"type":"string"},"example":"NGC224"},{"name":"messier","in":"query","required":false,"description":"Messier number, e.g. 31","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ra":"00:42:44.35","dec":"+41:16:08.6","name":"NGC0224","type":"G","b_mag":4.29,"v_mag":3.44,"ra_deg":10.68479,"dec_deg":41.26906,"messier":"M31","type_name":"Galaxy","common_name":"Andromeda Galaxy","hubble_type":"Sb","identifiers":"2MASX J00424433+4116074,IRAS 00400+4059,MCG +07-02-016,PGC 002557,UGC 00454","constellation":"And","messier_number":31,"major_axis_arcmin":177.83,"minor_axis_arcmin":69.66,"constellation_name":"Andromeda","surface_brightness":23.63},"meta":{"timestamp":"2026-05-31T05:48:02.731Z","request_id":"998de67e-d3d0-4c72-9079-2e1c1eac408f"},"status":"ok","message":"Object 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":["Deep-Sky"],"summary":"Search by name/common name with type & constellation filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name / common name search, e.g. nebula","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"G, PN, OCl, GCl, Neb, HII, SNR …","schema":{"type":"string"},"example":"PN"},{"name":"constellation","in":"query","required":false,"description":"Constellation (abbr or name), e.g. Orion","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":20,"limit":20,"total":130,"offset":0,"filters":{"type":"PN"},"results":[{"name":"IC0289","type":"PN","v_mag":13.2,"type_name":"Planetary Nebula","constellation":"Cas"},{"name":"IC0351","type":"PN","v_mag":11.9,"type_name":"Planetary Nebula","constellation":"Per"},{"name":"IC0418","type":"PN","v_mag":9.44,"type_name":"Planetary Nebula","constellation":"Lep"},{"name":"IC0972","type":"PN","v_mag":13.9,"type_name":"Planetary Nebula","constellation":"Vir"},{"name":"IC1266","type":"PN","v_mag":11.2,"type_name":"Planetary Nebula","constellation":"Ara"},{"name":"IC1295","type":"PN","v_mag":12.5,"type_name":"Planetary Nebula","constellation":"Sct"},{"name":"IC1297","type":"PN","v_mag":10.7,"type_name":"Planetary Nebula","constellation":"CrA"},{"name":"IC1454","type":"PN","v_mag":14,"type_name":"Planetary Nebula","constellation":"Cep"},{"name":"IC1747","type":"PN","v_mag":12,"type_name":"Planetary Nebula","constellation":"Cas"},{"name":"IC2003","type":"PN","v_mag":11.4,"type_name":"Planetary Nebula","constellation":"Per"},{"name":"IC2149","type":"PN","v_mag":10.78,"type_name":"Planetary Nebula","constellation":"Aur"},{"name":"IC2165","type":"PN","v_mag":10.5,"type_name":"Planetary Nebula","constellation":"CMa"},{"name":"IC2448","type":"PN","v_mag":10.4,"type_name":"Planetary Nebula","constellation":"Car"},{"name":"IC2501","type":"PN","v_mag":10.4,"type_name":"Planetary Nebula","constellation":"Car"},{"name":"IC2553","type":"PN","v_mag":10.3,"type_name":"Planetary Nebula","constellation":"Car"},{"name":"IC2621","type":"PN","v_mag":11.2,"type_name":"Planetary Nebula","constellation":"Car"},{"name":"IC3568","type":"PN","v_mag":10.6,"type_name":"Planetary Nebula","constellation":"Cam"},{"name":"IC4191","type":"PN","v_mag":10.6,"type_name":"Planetary Nebula","constellation":"Mus"},{"name":"IC4406","type":"PN","v_mag":10.2,"type_name":"Planetary Nebula","constellation":"Lup"},{"name":"IC4593","type":"PN","v_mag":10.7,"type_name":"Planetary Nebula","constellation":"Her"}]},"meta":{"timestamp":"2026-05-31T05:48:02.806Z","request_id":"89e52593-9c2f-4f1c-92f7-3b75b6b993d7"},"status":"ok","message":"Objects 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 & object-type breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Galaxies, nebulae and star clusters. Coordinates are J2000 (sexagesimal + decimal degrees); magnitudes V/B; size in arcminutes.","total":13308,"types":[{"code":"G","name":"Galaxy","count":10481},{"code":"OCl","name":"Open Cluster","count":652},{"code":"*","name":"Star","count":546},{"code":"Other","name":"Other","count":419},{"code":"**","name":"Double Star","count":243},{"code":"GPair","name":"Galaxy Pair","count":231},{"code":"GCl","name":"Globular Cluster","count":204},{"code":"PN","name":"Planetary Nebula","count":130},{"code":"Neb","name":"Nebula","count":94},{"code":"HII","name":"HII Ionised Region","count":82},{"code":"Cl+N","name":"Star Cluster + Nebula","count":67},{"code":"*Ass","name":"Association of Stars","count":62},{"code":"RfN","name":"Reflection Nebula","count":38},{"code":"GTrpl","name":"Galaxy Triplet","count":26},{"code":"SNR","name":"Supernova Remnant","count":11},{"code":"GGroup","name":"Galaxy Group","count":11},{"code":"EmN","name":"Emission Nebula","count":8},{"code":"Nova","name":"Nova Star","count":3}],"fields":["name","type","type_name","messier","common_name","constellation","ra","dec","ra_deg","dec_deg","v_mag","b_mag","major_axis_arcmin","hubble_type"],"source":"OpenNGC (NGC/IC deep-sky object catalogue)","messier":107,"with_common_name":131},"meta":{"timestamp":"2026-05-31T05:48:02.882Z","request_id":"0091a8b6-e171-429b-b20b-5d8dcb8d5283"},"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":4000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":550,"monthly_call_quota":50000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1750,"monthly_call_quota":260000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4500,"monthly_call_quota":1250000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/deepsky-api"}