> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wildfires

> List the wildfires burning near a point in the United States, largest first, with size, containment and discovery date.

List the wildfires currently burning within a distance of a point, given its latitude and longitude. Use it to check fire activity around a property, a facility or a route stop. Fires are returned largest first, each with its name, size in acres, the percent contained (null when the source states none), the date it was discovered (YYYY-MM-DD, UTC), and its state and county. `radius_km` sets the distance (1 to 200, default 50) and `limit` the most returned (1 to 25, default 10); `more` is true when the source held more fires in range than were returned. Covers current wildfire perimeters in the United States. A point with no fire in range is a completed result with an empty list; that means no published perimeter matched, not that no fire is near: a new fire may not have a perimeter yet.

## Authentication

Requires x402 payment in the `payment-signature` header.

## Request Body

<ParamField body="latitude" type="number" required>
  Latitude in decimal degrees, -90 to 90, for example 44.7. From -90 to 90.
</ParamField>

<ParamField body="longitude" type="number" required>
  Longitude in decimal degrees, -180 to 180 (west is negative), for example -120.0. From -180 to 180.
</ParamField>

<ParamField body="radius_km" type="number">
  Distance from the point in kilometres, 1 to 200; default 50. From 1 to 200. Defaults to `50`.
</ParamField>

<ParamField body="limit" type="integer">
  Most fires to return, 1 to 25; default 10. From 1 to 25. Defaults to `10`.
</ParamField>

<Snippet file="audit-context-params.mdx" />

## Response (200 OK)

Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.

<ResponseField name="data.request_id" type="string">
  Durable job ID for audit and lookup
</ResponseField>

<ResponseField name="data.status" type="string">
  Job status: `completed`
</ResponseField>

<ResponseField name="data.tool" type="string">
  Always `place_wildfires`
</ResponseField>

<ResponseField name="data.result" type="object">
  The answer, described under Result below
</ResponseField>

<ResponseField name="data.evidence" type="object">
  Where the answer came from and when
</ResponseField>

<ResponseField name="data.evidence.source" type="string">
  The public body the data comes from. Always `US National Interagency Fire Center`.
</ResponseField>

<ResponseField name="data.evidence.source_kind" type="string">
  `public` when the data comes from a public body, `commercial` otherwise
</ResponseField>

<ResponseField name="data.evidence.retrieved_at" type="string">
  When the lookup was made, as an ISO 8601 UTC time
</ResponseField>

<ResponseField name="data.evidence.as_of" type="string">
  When the source says the fact was last updated, or `null` when the source gives no date
</ResponseField>

## Result

Nested under `data.result`.

<ResponseField name="data.result.wildfires" type="object[]">
  Wildfires.
</ResponseField>

<ResponseField name="data.result.wildfires[].name" type="string">
  The incident name. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.wildfires[].acres" type="number">
  Size of the fire in acres. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.wildfires[].percent_contained" type="number">
  Percent of the fire perimeter contained, 0 to 100; null when none is stated.
</ResponseField>

<ResponseField name="data.result.wildfires[].discovered_on" type="string">
  Date the fire was discovered, YYYY-MM-DD (UTC). `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.wildfires[].state" type="string">
  Two-letter state code where the fire started. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.wildfires[].county" type="string">
  County where the fire started. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.more" type="boolean">
  True when the source held more fires in range than were returned.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-wildfires \
    -H "Content-Type: application/json" \
    -H "payment-signature: <base64 x402 payment>" \
    -d '{
      "latitude": 44.7,
      "longitude": -120,
      "radius_km": 100,
      "limit": 1
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-wildfires", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "payment-signature": paymentProof,
    },
    body: JSON.stringify({
      "latitude": 44.7,
      "longitude": -120,
      "radius_km": 100,
      "limit": 1
    }),
  });
  ```

  ```typescript SDK theme={null}
  const result = await agent.tool('lookup/place-wildfires', {
    latitude: 44.7,
    longitude: -120,
    radius_km: 100,
    limit: 1
  });
  console.log(result.data.result);
  console.log(result.data.evidence);
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200) theme={null}
  {
    "success": true,
    "data": {
      "request_id": "uuid",
      "receipt_id": "rcpt_...",
      "status": "completed",
      "tool": "place_wildfires",
      "result": {
        "wildfires": [
          {
            "name": "Crosswhite",
            "acres": 342923,
            "percent_contained": 100,
            "discovered_on": "2026-07-16",
            "state": "OR",
            "county": "Wheeler"
          }
        ],
        "more": true
      },
      "evidence": {
        "source": "US National Interagency Fire Center",
        "source_kind": "public",
        "retrieved_at": "2026-10-13T12:00:00.000Z",
        "as_of": null
      }
    }
  }
  ```
</ResponseExample>

<Info>Price: \$0.005 per lookup. See [Pricing](/pricing) for every tool.</Info>

## Notes

* Results return inline. The finished job stays available at `/v1/requests/{request_id}`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.