Compliance book API
Each license has its own acquisition and disposition book. An acquisition brings a firearm in; a disposition sends it out. A disposition that can be held keeps the firearm open until it is committed or cancelled.
Acquisitions
Record a receipt from another FFL, a manufacture, an import or a found firearm. A Type 07 or Type 10 maker records manufacture. A Type 08 or Type 11 importer records an import. Every acquisition, disposition, hold and correction stores recorded_by; there is no anonymous path.
- Assemble and disassemble a built firearm with
POST /v1/compliance/assembleandPOST /v1/compliance/disassemble. - A serial may have only one open line per manufacturer and license.
- A refused book entry does not change the book. The error gives a code and a message that says what was refused.
Dispositions
Record an FFL transfer, a retail 4473, an exempt transfer, a return to source, a theft or loss, a destruction or an NFA transfer. To commit a retail 4473, send a form4473_ref. To commit an NFA Form 3 or Form 5, send an nfa_form_ref; an NFA Form 4 needs both a form4473_ref and an nfa_form_ref. The book stores the reference you send; it does not invent one.
Holds and corrections
Only some transfer types can be held: FFL transfer, retail 4473, exempt transfer and NFA Forms 3, 4 and 5. A hold keeps one of those transfers open until it is committed or cancelled. A pending transfer older than 25 days appears as a stale hold in exceptions. A correction adds a version and a reason. The earlier version and its recorded_by remain readable.
Exceptions
GET /v1/compliance/exceptions lists late entries, stale holds, changes still not in FastBound after 24 hours, look-alike serials and a firearm that is open on two licenses. Each group lists the entries behind it, so an audit starts from the lines rather than a count.
FastBound sync
FastBound is the legal system of record by default. On a FastBound license, committed changes wait in a queue. Read it with GET /v1/compliance/sync and acknowledge an entry with POST /v1/compliance/sync/{id}/ack. Switching a license to RollStamp needs a recorded counsel sign-off and no FastBound change still waiting to sync.
FASTBOUND_ACCOUNT_NUMBER, FASTBOUND_API_KEY, FASTBOUND_AUDIT_USER and ROLLSTAMP_API_KEY are set. This build has no live FastBound account connected. FastBound remains the legal record by default.Deadlines and citations
Recording rules and deadlines live in a data table with a citation. A citation marked (verify) is waiting on a legal review. Do not treat a deadline in this guide as legal advice; read the citation on the rule.