Burn Check for agencies and developers
Put the Burn Check on your own website, or build on its API. It is free for fire departments, emergency management, government, schools and community organizations.
Burn Check is a screening aid only. It is not a burn permit, not an approval, not official guidance from any agency, and not a guarantee. Show Me Fire is not responsible for any fire, damage, injury, loss or legal consequence that results from using it, whether on this site or on yours. By using the API or the embed you accept the terms of use, which have a section for Burn Check.
Overview
For a Missouri location, Burn Check answers Do not burn, Use extreme caution or Conditions look okay, with the reasons. It looks at the county burn ban, National Weather Service Red Flag Warnings and Fire Weather Watches, current wind, humidity and fire danger, and today's hourly forecast. A burn ban or a fire weather alert always gives "Do not burn", and anything that could not be checked keeps the answer from being "okay".
There are two ways to use it: embed the public page in your website with an iframe (no code, and the required disclaimer is included), or call the API and build your own display. See the public Burn Check.
Quick start
No key is needed. Identify your application in the User-Agent header.
curl "https://api.showmefire.org/v1/burn-check?lat=38.9523&lon=-92.3738"curl "https://api.showmefire.org/v1/burn-check?address=205+Loch+Ln+Columbia+MO"Endpoints and limits
| Method | Path | What it does | Limit without a key |
|---|---|---|---|
| GET | /v1/burn-check?lat=&lon= or ?address= | The burn screening for one point. | 20 per minute per IP address |
| GET | /v1/burn-check/geocode?q= | Missouri matches for an address, town, zip code or "lat, lon". | 12 per minute per IP address |
| GET | /v1/burn-check/disclaimer | The disclaimer text, its version and the terms address. | 20 per minute per IP address |
A Show Me Fire API key (Authorization: Bearer <key>) raises the limits (ten times by default) here and on the rest of the public API, not only for Burn Check; see the API overview or request a key. Responses are enabled for browsers (CORS). /v1/burn-check answers are never cacheable (Cache-Control: no-store): they describe right now, so do not reuse one for more than a few minutes. Every response carries a Link: <https://showmefire.org/api-terms>; rel="terms-of-service" header.
The answer
| Field | Meaning |
|---|---|
verdict.state | not_safe, caution or conditions_ok: stable values for your code. |
verdict.label | The exact text to show: "Do not burn", "Use extreme caution", "Conditions look okay". |
verdict.headline | One plain sentence for the state. |
reasons[] | {code, level, text}: why. level is not_safe or caution, most serious first. Codes include burn_ban, fire_weather_alert, fire_danger, wind, gust, humidity, heat, worsening, data_missing and unchecked_*. |
burn_ban | {checked, active, details}: a county burn ban reported to Show Me Fire. checked: false means it could not be checked. |
alerts | {checked, active[]}: National Weather Service Red Flag Warnings and Fire Weather Watches for the county. |
current | Latest analysis at the point: temp_f, rh_pct, wind_mph, fire_danger (0-4) and its label, observed_at. May be null. |
today | {available, hours[], best_window}: each remaining hour of today with its state, wind, humidity and temperature, and the longest run of "okay" hours. |
location | The point, the county, and matched_address when an address was used. alternatives[] lists other address matches. |
notes[] | Things that limit this answer (for example, the hourly forecast is missing). Show them. |
rules | The version and thresholds used: Show Me Fire's own conservative screening limits, not official guidance. |
disclaimer | {version, short, full, terms_url}. Show short next to every answer and make full reachable. |
generated_at | When the answer was made (UTC). |
Treat any failure as "unknown", never as "okay". The thresholds are Show Me Fire's own conservative screening limits and are returned in rules with a version, so you can show how an answer was reached.
Errors
| Status | Meaning |
|---|---|
404 | The address was not found in Missouri (detail says so). |
422 | Bad input, or the point is outside Missouri. |
429 | Rate limited. Wait a minute. |
503 | Address lookup is unavailable. Try coordinates. |
Embed it on your website
Paste the iframe where you want it. It shows the same Burn Check as the public page, asks each visitor to acknowledge the disclaimer before any lookup, and keeps the "Powered by Show Me Fire" credit. allow="geolocation" lets the "Use my location" button work inside the frame.
1. Copy the iframe
<iframe src="https://showmefire.org/embed/burn-check" title="Burn Check"
width="100%" height="720" style="border:0;max-width:640px"
allow="geolocation" loading="lazy"></iframe>2. Optional: follow the frame's height
The frame tells your page how tall it needs to be. Add this script after the iframe so the frame never shows its own scrollbar.
window.addEventListener('message', function (e) {
if (e.origin === 'https://showmefire.org' && e.data && e.data.type === 'smf-burn-check-height') {
document.querySelector('iframe[title="Burn Check"]').style.height = e.data.height + 'px';
}
});Live preview
The embed is for general awareness. Do not hide, shorten or change the disclaimer, the answer's label or the credit.
Rules in one list
- Show the disclaimer next to every answer.
- Show the label as given. Never call it "safe", "approved" or "permitted".
- Do not present it as official, or as a permit.
- Keep the "Powered by Show Me Fire" credit.
- Stay within the limits, and do not keep an answer for more than a few minutes.
- Do not use it to issue or automate permits, or for emergencies. Call 911 for fires.
- Do not keep your visitors' addresses beyond what you need.
The full text is in the terms of use.
Terms of use
Terms version 2026-10-20.
The Burn Check API, API keys and the embeddable page are covered by the Show Me Fire API and data terms of use. Please read them: they say that the data and tools are not official, not a permit and not a guarantee, and that Show Me Fire is not responsible for any fire, damage, injury, loss or other consequence that results from using them, whether on this site or on yours.
Burn Check: the additional rules
- Show
disclaimer.shortfrom the response next to every answer, and makedisclaimer.fullreachable from it. The iframe embed does this for you. - Show the answer label exactly as given (Do not burn / Use extreme caution / Conditions look okay), without changing its meaning, softening it, or showing it without its reasons. Never describe an answer as "safe", "approved" or "permitted". "Conditions look okay" is never a guarantee that burning is safe or legal.
- Do not use an answer older than a few minutes: it describes right now.
Keys and contact
A Show Me Fire API key is general: one key raises your limits on the whole public API, not only on Burn Check (see the API overview). Keys are issued to approved users. Tell us who you are, what you will build or embed, and roughly how much you expect to use. A staff member reviews every request, and an approved key is sent to you by email.
To ask about commercial use, or to tell us about a problem, use the contact page.
In an emergency, call 911. Burn Check is not an alerting or emergency service.
