burnban

Current fire restrictions and campfire rules for any point in Arizona, on any date, with the official source and the time it was last checked.

Disclaimer. Informational only. Verify with the land manager before lighting any fire. Not legal advice.

What this is

Buyers are AI agents and the people who build them: trip planners, outdoor assistants, camping tools. Send a latitude and longitude, get back every jurisdiction that contains the point, its restriction stage and rules, a computed effective block with the most restrictive rule per field, and a link to the signed source for each answer. When burnban does not know, it says unknown rather than guessing.

Coverage

Arizona only. Coverage is per jurisdiction and grows over time. Each jurisdiction reports a coverage_level of full, partial or planned, plus its last_verified time. A point in a planned area returns unknown with the nearest official sources. The live list is free: GET https://api.burnban.app/v1/coverage.

Endpoints

RouteCostPurpose
GET /v1/lookup?lat=&lon=&date=$0.01Restrictions for a point. date is optional, formatted YYYY-MM-DD, and defaults to today in America/Phoenix.
GET /v1/coveragefreeJurisdictions, coverage level, last verified time.
GET /v1/healthfreeBuild id, database reachability, last successful ingest time.
POST /mcptool dependentMCP server over Streamable HTTP.
GET /.well-known/x402.jsonfreeMachine-readable payment terms.

Invalid input returns 400 with {"error": {"code": "invalid_request", "message": "..."}} and is never charged. A failed lookup is not charged either.

Price and how to pay

Each lookup costs $0.01, paid in USDC with x402 version 2, scheme exact, on Base mainnet (eip155:8453). Pay to not configured yet. No account and no API key.

  1. Request /v1/lookup without payment. The server answers 402 with a base64 JSON PAYMENT-REQUIRED header listing the accepted payment.
  2. Sign the payment and retry the same request with a PAYMENT-SIGNATURE header.
  3. On success the response is 200 and carries a base64 JSON PAYMENT-RESPONSE header with the settlement transaction.

With @x402/fetch this is handled for you:

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(KEY)) }],
});
const res = await pay("https://api.burnban.app/v1/lookup?lat=35.19&lon=-111.63");
console.log(await res.json());

Payment terms in machine-readable form: /.well-known/x402.json. Responses to paid routes are sent with Cache-Control: no-store.

MCP server

Endpoint: https://api.burnban.app/mcp, Streamable HTTP. Tools:

Response fields

Every field of the /v1/lookup response, and of the get_fire_restrictions tool result, which is the same JSON.

FieldMeaning
queryThe request as interpreted.
query.latLatitude in decimal degrees (WGS84).
query.lonLongitude in decimal degrees (WGS84).
query.dateRequested date (YYYY-MM-DD, Arizona time); today in America/Phoenix when omitted.
query.date_ruleHow the date became an instant: today = the request time; past = 12:00 Arizona time that day; future = rules in force now plus published orders starting by 12:00 that day.
query.evaluated_atInstant the rules were evaluated at, ISO 8601 with the Arizona offset (-07:00).
jurisdictionsEvery jurisdiction whose boundary contains the point, national forests first, then counties, then cities.
jurisdictions[].idStable jurisdiction id, for example usfs-coconino.
jurisdictions[].typenational_forest, county or municipality.
jurisdictions[].nameOfficial name.
jurisdictions[].agencyAgency that issues the orders.
jurisdictions[].coverage_levelfull, partial or planned. Planned jurisdictions always answer unknown.
jurisdictions[].ranger_districtRanger district containing the point, for national forests; its orders are folded into this entry.
jurisdictions[].ranger_district.idRanger district id.
jurisdictions[].ranger_district.nameRanger district name.
jurisdictions[].mirrorsId of the jurisdiction whose orders this one copies because it has no source of its own, or null.
jurisdictions[].statusrestrictions (at least one rule is restricted), no_restrictions (recently checked and no order restricts anything), or unknown.
jurisdictions[].restriction_stageFire danger stage of the stage order in force (0 to 3). 0 means no stage order is in force, though standing year-round orders may still restrict fires. Null when unknown.
jurisdictions[].rulesOne value per rule field, the most restrictive across this jurisdiction's orders in force.
jurisdictions[].rules.{field}Rule value from the enum for that field, or unknown. allowed means no order we track restricts it; standing laws still apply.
jurisdictions[].conditionsPlain-language limits and exceptions from the order that supplied each rule, where the order states any.
jurisdictions[].conditions.{field}Conditions for that rule field.
jurisdictions[].order_numberNumber of the main order in force (the stage order if any), or null.
jurisdictions[].effective_sinceStart of the main order, ISO 8601 with offset.
jurisdictions[].effective_untilScheduled end of the main order, ISO 8601 with offset, or null when open ended.
jurisdictions[].source_urlOfficial document for the main order, or the agency alerts page when no order is in force.
jurisdictions[].last_verifiedLatest successful check of this jurisdiction's sources at or before the freshness instant (UTC).
jurisdictions[].confidencehigh, medium or low. Lowered one level when last_verified is over 72 hours old, capped at low for mirrored jurisdictions and at medium for future dates. Null when unknown.
jurisdictions[].ordersEvery order in force for this jurisdiction at the evaluation instant.
jurisdictions[].orders[].jurisdiction_idJurisdiction that issued the order (a ranger district for district orders).
jurisdictions[].orders[].order_numberOrder number as printed, or null when the agency did not number it.
jurisdictions[].orders[].titleOrder title.
jurisdictions[].orders[].stagestage_0 to stage_3, year_round or other.
jurisdictions[].orders[].effective_sinceOrder start, ISO 8601 with offset.
jurisdictions[].orders[].effective_untilScheduled order end, ISO 8601 with offset, or null.
jurisdictions[].orders[].areaArea the order covers, as the order describes it.
jurisdictions[].orders[].source_urlOfficial order document.
jurisdictions[].orders[].confidenceConfidence in the extracted order.
jurisdictions[].notesCaveats for this jurisdiction: boundary meaning, mirroring, staleness, district order areas.
effectiveMost restrictive answer across all jurisdictions that are not unknown.
effective.restriction_stageHighest restriction_stage among those jurisdictions, or null.
effective.rulesOne entry per rule field.
effective.rules.{field}Winning value for that rule field.
effective.rules.{field}.valueMost restrictive known value; unknown never wins over a known value.
effective.rules.{field}.fromId of the jurisdiction that supplied the value, or null when unknown.
effective.rules.{field}.order_numberOrder that supplied the value, or null.
effective.rules.{field}.conditionsConditions attached to the winning value, or null.
effective.confidenceLowest confidence among the jurisdictions that supplied a value; capped at medium when any jurisdiction is unknown or the point is near a boundary. Null when nothing is known.
unknownIds of jurisdictions whose answer is unknown (planned coverage, stale data or never checked).
nearest_sourcesOfficial pages to check by hand when something is unknown.
nearest_sources[].jurisdiction_idJurisdiction the page belongs to, or null for a statewide page.
nearest_sources[].namePage owner.
nearest_sources[].urlPage URL.
near_boundaryTrue when the point is within about 12 m of a boundary in the simplified boundary data, so membership may be wrong.
date_noteExplains future-date handling and any order that starts or ends on the requested date; null otherwise.
notesCaveats for the whole answer.
disclaimerAlways present. Informational only; not legal advice.
generated_atWhen this response was generated (UTC).

Coverage fields

Every field of the /v1/coverage response and the get_coverage tool result.

FieldMeaning
jurisdictionsEvery jurisdiction burnban knows about.
jurisdictions[].idStable jurisdiction id.
jurisdictions[].typenational_forest, ranger_district, county or municipality.
jurisdictions[].nameOfficial name.
jurisdictions[].agencyAgency that issues the orders.
jurisdictions[].parent_idParent jurisdiction (the forest, for a ranger district), or null.
jurisdictions[].mirrorsId of the jurisdiction whose orders this one copies, or null.
jurisdictions[].coverage_levelfull, partial or planned.
jurisdictions[].source_countEnabled sources owned by this jurisdiction.
jurisdictions[].verified_viaJurisdiction whose sources verify this one (parent forest or mirrored jurisdiction), or null.
jurisdictions[].last_verifiedLatest successful source check (UTC), or null.
jurisdictions[].freshnessfresh (72 hours or less), stale (over 72 hours), expired (over 14 days, lookups answer unknown) or never.
jurisdictions[].noteCaveat for this jurisdiction, or null.
disclaimerAlways present. Informational only; not legal advice.
generated_atWhen this response was generated (UTC).

Rule values

Each key of rules takes one of these values. Order is least to most restrictive, and effective uses that order. unknown never wins over a known value.

Rule fieldValues, least to most restrictive
campfiresallowed developed_sites_only prohibited unknown
charcoalallowed developed_sites_only prohibited unknown
gas_stovesallowed allowed_with_shutoff_valve prohibited unknown
smokingallowed enclosed_vehicle_or_building_or_developed_site_only enclosed_vehicle_or_building_only prohibited unknown
fireworksallowed prohibited unknown
explosivesallowed prohibited unknown
target_shootingallowed prohibited unknown
areaopen closed unknown

Freshness and confidence

Official sources are checked at least daily, and every few hours in fire season. A response is only as fresh as its last_verified. Confidence drops one level when the last verification is older than 72 hours, and the answer becomes unknown after 14 days. Every first-season order is reviewed by a person before it is published.

Contact

Questions, corrections and source problems: https://api.burnban.app/docs.