API for vendors.

Get a key

A chief or officer signs in to the department's FirePreplans setup, opens Vendor keys and makes a key with your name on it. They copy it to you once; we keep only a hash, so we cannot read it back or send it again. The department can cancel a key at any time, and it stops at once.

Send the key on every request, as Authorization: Bearer fpp_... or X-Api-Key: fpp_.... Call the API from your server only. A key in a browser or an app can be copied.

Always current

Every card has a link, the url field. The link never changes and always opens the newest card, so the simplest use is to show that link next to the address. To keep your own copy, read every card once, then ask for changes. The cards change when the department changes its setup and when we rebuild them with newer public records. Once an hour is plenty.

Requests

curl https://firepreplans.com/api/v1/cards \
  -H "Authorization: Bearer fpp_..."

One card:

{
  "department": { "fdid": "PA-00000", "name": "Example Fire Company" },
  "slug": "100-example-rd",
  "url": "https://firepreplans.com/plans/46/100-example-rd",
  "updated_at": "2026-10-24T21:23:06Z",
  "fields": {
    "box": "46-11",
    "address": "100 Example Rd",
    "building_type": "Home",
    "water_need_gpm": 550,
    "water_plan": "Hydrant",
    "hydrant_ft_by_road": 288,
    "alert_line": "100 EXAMPLE RD | BOX 46-11 | ...",
    ...
  }
}

Changes:

curl "https://firepreplans.com/api/v1/changes?since=2026-10-24T00:00:00Z" \
  -H "Authorization: Bearer fpp_..."

{
  "since": "2026-10-24T00:00:00Z",
  "until": "2026-10-25T06:00:00Z",
  "changed": [{ "slug": "100-example-rd", "updated_at": "2026-10-24T21:23:06Z", "what": ["card"] }],
  "removed": []
}

Every time is UTC, written like 2026-10-24T21:23:06Z.

Fields

An empty field is null. Values marked estimated or unverified stay that way until the department's crew checks the card.

Owner answers

Building owners can tell the department about their building through the code on each card. An officer checks every answer before it goes on a card. When the department ticks owner answers for your key, each card also has owner: the answers the officer approved and when. A changed owner answer shows in changes with "owner" in what. Show owner answers only to the department's members.

Errors

An error comes back as JSON with error and message.

Questions about the API: send us a note with the note box on this page.