Put reviewed half-staff information into your website, intranet, building screens, or team chat. Every format comes from the same evaluator as this site, and every format says so plainly when status cannot be verified.
JSON status
GET https://flagsathalfstaff.org/api/status/{state}.json, where state is us or a state slug such as new-york or district-of-columbia. Cross-origin requests are allowed. Responses are cached for about two minutes.
The status field is one of half_staff_order_active, no_applicable_order_found, or verification_unavailable. Treat verification_unavailable as unknown, never as full staff.
{
"jurisdiction": "new-york",
"status": "verification_unavailable",
"title": "Flag Status Could Not Be Verified",
"reason": "Check the latest official information before changing your display.",
"end": null,
"last_successful_check": null,
"details": "https://flagsathalfstaff.org/states/new-york/",
"note": "Official orders control. verification_unavailable never means full staff.",
"attribution": "Flags At Half Staff by Atlantic Flagpole, https://flagsathalfstaff.org"
}Notice feeds (RSS)
- National:
https://flagsathalfstaff.org/feeds/national.xml - By state, including national notices:
https://flagsathalfstaff.org/feeds/{state}.xml - Articles:
https://flagsathalfstaff.org/blog/feed.xml
Calendar (iCalendar)
https://flagsathalfstaff.org/calendar/national.ics lists confirmed observances and scheduled orders. Calendar apps refresh on their own schedule, so new orders can appear late.
Widgets and lobby screens
Use the widget builder for a banner, card, compact line, or a no-script image badge. For a lobby TV or digital sign, open the display view in TV mode; it refreshes every five minutes and also prints as a notice.
Good practice
- Keep the attribution link visible so people can reach the official source.
- Do not cache a status for longer than an hour, and show the check time where you can.
- For decisions about a specific facility, follow the issuing authority's instruction.
Coming later
Webhooks that notify your system when an order starts, changes, or ends are planned. Tell us how you would use them.