Skip to content
Compliance book

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/assemble and POST /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.

The queue, acknowledgement endpoints and the adapter that drains the queue into FastBound are built. The adapter is off until 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.