{"uid":"cap_8qSbKJt5N0pulnOXZQGqf","slug":"vextorium-satellite-passes-bff579ea","name":"Vextorium Satellite Passes","description":"Next passes of a satellite over a location (ISS by default, any NORAD id): rise, culmination and set times in UTC, max elevation, direction and whether it will be sunlit under a dark sky (visible to the naked eye). Orbits from CelesTrak.","url":"https://api.vextorium.com/v1/satellite-passes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["lat","lon"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"days":{"type":"integer"},"norad":{"type":"integer"},"min_elevation":{"type":"number"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"days":{"type":["number","null"]},"norad":{"type":["number","null"]},"place":{"type":["object","null"],"properties":{"lat":{"type":["number","null"]},"lon":{"type":["number","null"]}}},"passes":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"to":{"type":["null","string"]},"since":{"type":["null","string"]},"sunlit":{"type":["boolean","null"]},"dark_sky":{"type":["boolean","null"]},"sets_utc":{"type":["null","string"]},"rises_utc":{"type":["null","string"]},"max_elevation":{"type":["null","number"]},"culminates_utc":{"type":["null","string"]},"visible_to_naked_eye":{"type":["boolean","null"]}}}},"source":{"type":["string","null"]},"satellite":{"type":["string","null"]}}}}}}},"responseSchema":{"type":"json","example":{"days":2,"norad":25544,"place":{"lat":40.4168,"lon":-3.7038},"passes":[{"to":"NE","since":"SW","sunlit":true,"dark_sky":false,"sets_utc":"2026-10-04T09:54:53Z","rises_utc":"2026-10-04T09:48:10Z","max_elevation":60.7,"culminates_utc":"2026-10-04T09:51:31Z","visible_to_naked_eye":false},{"to":"NE","since":"W","sunlit":true,"dark_sky":false,"sets_utc":"2026-10-04T11:31:23Z","rises_utc":"2026-10-04T11:25:47Z","max_elevation":23,"culminates_utc":"2026-10-04T11:28:35Z","visible_to_naked_eye":false}],"source":"CelesTrak (orbits) and Skyfield (computation)","satellite":"ISS (ZARYA)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kd2PYqcgIak4c8-1pXjqn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming visible passes of a satellite (by NORAD ID) over a given geographic coordinate, including rise/set times, max elevation, and naked-eye visibility.","exampleAgentPrompt":"When will the ISS pass over Madrid (40.4168°N, 3.7038°W) in the next 2 days? Show me all passes with at least 10 degrees elevation, including whether they'll be visible to the naked eye.","exampleUseCases":[{"title":"ISS spotting night from home","prompt":"When is the next time the ISS will be visible from my backyard in Austin, Texas (30.2672°N, 97.7431°W) over the next 3 days? I only care about passes where it gets at least 20 degrees above the horizon."},{"title":"Amateur astronomer satellite scheduling","prompt":"I need to plan a satellite observation session. Can you give me all passes of NORAD satellite 25544 over Tokyo (35.6762°N, 139.6503°E) for the next 5 days, especially ones where the satellite is sunlit against a dark sky?"},{"title":"Astrophotography window planning","prompt":"I want to photograph the ISS passing over London (51.5074°N, 0.1278°W) — what passes are coming up in the next 2 days where max elevation is high enough to get a good shot?"}],"resultDescription":"A JSON object listing all predicted satellite passes over the given location within the requested window. Each pass entry includes rise time, set time, culmination time (all in UTC), direction the satellite rises from and sets to, maximum elevation angle, whether the satellite is sunlit, whether the sky is dark, and whether it is visible to the naked eye. Also includes the satellite name and data source attribution.","failureModes":["Missing required lat/lon fields returns a validation error","Invalid NORAD ID returns no results or an error","Very short forecast window (days=0) may return empty passes array","Locations at extreme latitudes may have no passes in the window","API returns HTTP 402 if USDC payment is not provided via x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need precise, computation-backed satellite pass predictions for a specific geographic coordinate, especially for the ISS or any NORAD-catalogued satellite. It is ideal for astronomy apps, observation planners, or astrophotography scheduling. Prefer it over generic space APIs when you need naked-eye visibility flags, sunlit/dark-sky conditions, and directional rise/set data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:52:01.804Z","isFirstParty":false,"canonicalSlug":"vextorium-satellite-passes-bff579ea"}