{"uid":"cap_szuSFE2yTz0kA2ddS4TAe","slug":"fittings-sunrise-sunset-times-02518ce4","name":"fittings Sunrise/Sunset Times","description":"UTC sunrise, sunset, solar noon and day length for a date and coordinate, including polar day/night.","url":"https://fittings.sh/v1/time/sunrise-sunset","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["date","lat","lon"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"date":{"type":"string","description":"ISO date YYYY-MM-DD"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_rYLUO8C_-Dungb2ItBTDl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns UTC sunrise, sunset, solar noon, and day length for any date and geographic coordinate, including polar day and night handling.","exampleAgentPrompt":"What time does the sun rise and set in Reykjavik, Iceland on June 21, 2025 — and will it actually get dark that night?","exampleUseCases":[{"title":"Polar night check for expedition planning","prompt":"I'm planning a research trip to Longyearbyen, Norway (latitude 78.22, longitude 15.65) on January 15, 2026 — will there be any daylight at all, and if so when does the sun rise and set?"},{"title":"Golden hour timing for outdoor photography","prompt":"I'm doing a photoshoot in Sedona, Arizona (lat 34.87, lon -111.76) on March 8, 2025 — what time is sunrise and solar noon so I can plan for the best golden hour light?"},{"title":"Scheduling outdoor event start time","prompt":"We're hosting an outdoor evening event in Sydney, Australia (lat -33.87, lon 151.21) on November 1, 2025 — what time does the sun set so we know when to start the lighting?"}],"resultDescription":"Returns UTC times for sunrise, sunset, and solar noon for the specified date and coordinate, along with the total day length in seconds or human-readable form, and flags for polar day (sun never sets) or polar night (sun never rises).","failureModes":["Invalid date format (not YYYY-MM-DD) returns a 400 error","Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns a validation error","Missing required query parameters (date, lat, or lon) returns a 400 bad request","Extreme polar coordinates may return polar day or polar night flags with null sunrise/sunset times","Payment failure or insufficient USDC balance returns a 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need precise UTC solar event times (sunrise, sunset, solar noon, day length) for any date and coordinate worldwide, especially when polar regions and their edge cases (midnight sun, polar night) need to be handled correctly. Prefer this over general weather APIs that may only return local-time approximations or lack polar handling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:12:15.587Z","isFirstParty":false}