Fields
Only the licence number, in the address. Needs FFL dealers: Read, a permission of FFL Checkout stores.
- Any form of the number finds it: printed (
1-62-037-01-3F-01187), composed, without separators, in any case, or thelicense_keya search answered with. - Whatever its status. The newest registry row for the licence answers, so "expired" and "taken out of searches" are answers, not a
404. A licence a store uploaded that is still waiting for FFL Monkey's approval, or was rejected, is never answered. - Before you ship, check
transfer_eligibleandverification.current: a search only ever finds dealers for whom both are true, but a number a buyer typed may not be one. - It counts towards the 120 searches a minute from one address that your store's dealer picker counts towards too, and not towards the store's daily search limit.
What it answers
data is the licence in full: a dealer in the search's shape, with licensee_name always sent and distance_meters always null, plus:
| Field | Meaning |
|---|---|
| status | The registry row's status. active: searchable. expired: its licence ran out. inactive or rejected: taken out of searches by FFL Monkey. pending_verification: entered and not yet confirmed. Only active dealers appear in a search. |
| license_type | The ATF licence type, two digits: 01 dealer, 02 pawnbroker, 06 ammunition manufacturer, 07 firearms manufacturer, and so on. |
| transfer_eligible | Whether a firearm may be transferred to a holder of this licence type. |
| verification | Whether the licence is real and current, below. |
verification | Meaning |
|---|---|
| real | The licence comes from ATF's own list, or from a licence document a store uploaded and FFL Monkey approved. |
| current | The dealer is active and its licence expires today or later (UTC). false when the expiry is not known. |
| source | atf_import: ATF's list. contribution: an approved upload. operator_manual: entered by FFL Monkey staff. |
| last_verified_at | When the row was last confirmed, by an ATF import or an approval, or null. |
Returns
- 200The licence, in
data. - 404dealer_not_found: the registry has no dealer for this number, in any form, or only an upload still pending or rejected.
- 404not_found: the address holds something that is not 5 to 32 letters, digits and hyphens.
This endpoint can also answer 401 invalid_api_key, 403 license_not_active, 403 product_not_included, 403 insufficient_scope and 429 rate_limited.