{"uid":"cap_KLssQGYiFDdjpqj6VG_Rq","slug":"fittings-solar-twilight-windows-c137bfa0","name":"fittings Solar Twilight Windows","description":"Civil, nautical and astronomical twilight boundaries plus golden and blue hour windows for a date and coordinate, in UTC.","url":"https://fittings.sh/v1/solar/twilight-windows","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","description":"Latitude, -90 to 90"},"lon":{"type":"number","description":"Longitude, -180 to 180"},"date":{"type":"string","description":"ISO date YYYY-MM-DD, interpreted in UTC"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P1_P5m-1WiLxf4AQGP8nC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns civil, nautical, and astronomical twilight boundaries plus golden and blue hour windows for a given date and coordinate, in UTC.","exampleAgentPrompt":"What are the civil, nautical, and astronomical twilight times plus golden hour and blue hour windows for Reykjavik (64.1355° N, 21.8954° W) on July 15, 2025?","exampleUseCases":[{"title":"Golden hour photography shoot planning","prompt":"I have a landscape shoot in Sedona, Arizona (34.8697° N, 111.7610° W) on September 3, 2025 — when exactly does golden hour start and end, and when is blue hour?"},{"title":"Stargazing and astrophotography site check","prompt":"I'm doing astrophotography at Cherry Springs State Park (41.6620° N, 77.8247° W) on August 22, 2025 — what time does astronomical twilight end so I know when the sky will be fully dark?"},{"title":"Nautical departure window planning","prompt":"We're sailing out of Newport, Rhode Island (41.4901° N, 71.3128° W) on October 10, 2025 and need to depart at first nautical twilight — what time is that?"}],"resultDescription":"A JSON response containing UTC timestamps for the start and end of civil, nautical, and astronomical twilight, along with golden hour and blue hour windows, all calculated for the specified date and WGS-84 coordinate.","failureModes":["Missing required query parameters (date, lat, or lon) returns a validation error","Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns an error","Malformed date string (not YYYY-MM-DD) returns a parsing error","Extreme polar coordinates on dates with midnight sun or polar night may return unusual or empty windows","Payment failure or insufficient funds returns a 402 response"],"whenToPreferThis":"Choose this endpoint when you need precise UTC twilight boundary times (civil, nautical, astronomical) and golden/blue hour windows for any geographic coordinate and date. It's ideal for photography planning, astronomical observation scheduling, nautical departure planning, or drone flight window calculation. Prefer it over generic solar APIs when you need all twilight categories plus golden and blue hour in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:39.793Z","isFirstParty":false}