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.0.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 by ZIP, city/state, or coordinates with API key authentication and usage tracking.

GET/api/v1/public/search

Public widget search

Rate-limited search for embedded customer-facing experiences. Dealer email is not returned.

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://fflbridge.com/api/v1/search?zip=32174&radius=25&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Browser widget search

const res = await fetch(
  "https://fflbridge.com/api/v1/public/search?zip=32174&radius=25"
);
const data = await res.json();