I see, I would've never thought about such edge cases myself! 
What do you think about searching the earliest candles item(which falls on Friday), and then approximating the Havdalah date myself by using the next day with the havdalah item's time?

Also regarding the provided urls, the docs have nothing about the "zip" parameter. What does it do?

Thanks a lot! Just to be extra safe, can you confirm that this workflow always achieves the next Shabbat dates?

1. Get the current date. If it's Saturday, increase the day of month by 1.
2. Query the Shabbat API along with the adjusted date.
3. Extract the entrance and end dates by the candles and havdalah fields respectively

Hello, thank you for responding.

• So if I understand you correctly, on Saturday I need to wait until 00:00(Start of Sunday) and then query the API?
  Would it be safer to wait an extra minute just to verify I get the next Shabbat info?
  
  
• By "typically" do you mean definitely? This is why I asked what the intended way is.
  For now I've changed my code to match against the category, but I'd be glad if you could clarify.
  
  Regarding the full API, it similarly returned data I didn't ask for even after experimenting with the docs.
  In my humble opinion the docs are confusing; But since I managed to get what I needed, There's no need dive into that here.