API reference

Build FFL dealer lookup into any checkout.

Use FFL Bridge as a flexible API for custom storefronts, internal fulfillment tools, and checkout flows. The WooCommerce plugin is available, but the API is the core platform.

Download OpenAPI JSON Read integration docs

1.2.0

Version

Bearer or X-API-Key

Auth

ZIP, city/state, lat/lng

Search inputs

/openapi.json

Spec

Core Endpoints

GET/api/v1/search

Authenticated dealer search

Search current ATF-listed dealers by ZIP, city/state, or coordinates, with explicit verification, transfer acceptance, promotion, and checkout eligibility fields.

GET/api/v1/public/search

Public demonstration search

Unauthenticated, IP-rate-limited demonstration endpoint for FFL Bridge public pages—not for customer integrations or the widget.

GET/api/v1/ffls/{id}

Authenticated dealer detail

Revalidate one selected dealer and retrieve safe checkout-eligibility metadata without exposing license documents or internal fields.

POST/api/v1/orders

Create order with selected FFL

Attach the customer and selected dealer to an order workflow for fulfillment follow-up.

GET/api/v1/usage

Usage summary

Check current API calls, daily usage, top endpoints, limits, and overage estimates.

Authenticated search

curl "https://www.fflbridge.com/api/v1/search?zip=32174&radius=25&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Browser-key search

const res = await fetch(
  "https://www.fflbridge.com/api/v1/search?zip=32174&radius=25",
  { headers: { "X-API-Key": "ffl_pub_YOUR_BROWSER_KEY" } }
);
const data = await res.json();