---
title: Quickstart
description: Fetch satellite wildfire data from our low-latency API.
---

## 1. Get a token

Create an API client under **Settings → API clients** at
[app.deepfire.co](https://app.deepfire.co). See
[Authentication](/guides/authentication) for the details.

```bash
export TOKEN=$(curl -s -X POST "https://api.deepfire.co/v1/token" \
  -H "Content-Type: application/json" \
  -d "{\"client_id\": \"$DEEPFIRE_CLIENT_ID\", \"client_secret\": \"$DEEPFIRE_CLIENT_SECRET\"}" \
  | jq -r .access_token)
```

## 2. Explore the service

```bash
# Landing page — links to conformance, collections, and the OpenAPI definition
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1?f=application/json"

# What can this server do? (conformance classes)
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/conformance?f=application/json"

# List collections
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections?f=application/json"
```

## 3. First features

```bash
# The first 10 hotspots as GeoJSON (`+` must be percent-encoded as %2B in a bare URL)
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items?f=application/geo%2Bjson&limit=10"
```

## 4. Active hotspots in a bounding box

Combine a spatial filter (`bbox`, WGS84 lon/lat) with an attribute filter
([CQL2](/guides/filtering)). Example: currently-active detections over California.

```bash
curl -sG -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items" \
  --data-urlencode "bbox=-125,32,-114,42" \
  --data-urlencode "filter-lang=cql2-text" \
  --data-urlencode "filter=active = true" \
  --data-urlencode "limit=1000" \
  --data-urlencode "f=application/geo+json"
```

## 5. One feature by ID

Feature IDs look like `hotspots.<uuid>` and come from items responses:

```bash
id=$(curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items?f=application/geo%2Bjson&limit=1" \
  | jq -r '.features[0].id')

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:hotspots/items/$id?f=application/geo%2Bjson"
```