Read FastBound account properties and settings (number, name, items in inventory, owner). Useful as a connectivity/credential check. Read-only.

Return one of FastBound's reference lists (allowed values). Use this to discover valid caliber/manufacturer/type/condition/location/importer values before creating or editing records. Read-only.

List users on the account. Use this to find valid emails for the X-AuditUser header required on write operations. Read-only.

Search the firearm inventory (the A&D book). Filter by serial, manufacturer, model, type, caliber, status, date ranges, TTSN/OTSN, and more. Returns a page of items plus the total record count. Read-only.

Retrieve a single firearm record by FastBound GUID id or by your externalId. Read-only.

Edit fields on an existing firearm record. Performs a read-merge-write so unspecified fields keep their current values. Dry-run by default (preview shows the merged body); pass confirm:true to apply. Write.

Set or change only the externalId of an item (links it to your system's record) without touching other fields. Write.

Set the acquisition (source) contact on an item. Executes directly. Write.

Delete a firearm record. ATF permits deletion only for a Duplicate or Error; a deleteType and an explanatory deleteNote are required and form an immutable audit entry. Dry-run by default; pass confirm:true to delete. Destructive write.

Reverse a disposition: return a disposed firearm to available inventory. Dry-run by default; pass confirm:true to apply. Write.

Search acquisition records (intake events). Filter by type, PO/invoice/tracking number, supplier contact, item, and manufacturing flag. Read-only.

Retrieve a single acquisition by FastBound GUID id or your externalId. Read-only.

Retrieve a single item within an acquisition. Read-only.

Record an acquisition and commit it to the A&D book in one step (the recommended intake path). A supplier contact is REQUIRED — provide contactId, contactExternalId, or an inline contact. This commits a regulated record: dry-run by default, pass confirm:true to execute. Write.

Create a PENDING (uncommitted) acquisition draft. A supplier contact is REQUIRED (contactId, contactExternalId, or inline contact). Has no ATF effect until committed, so it executes directly (no dry-run). Add items with add_acquisition_items, then finalise with commit_acquisition. Write.

Add a single firearm to a pending acquisition. Executes directly (the acquisition is still uncommitted). Write.

Edit header fields (type, date, note, PO/invoice/tracking, externalId) on a PENDING acquisition. Read-merge-write so unspecified fields keep their current values. Dry-run by default; pass confirm:true. Write.

Replace an item within a pending acquisition with corrected firearm data. Supply the full item (PUT replaces it). Dry-run by default; pass confirm:true. Write.

Assign an existing supplier contact to a pending acquisition. Executes directly. Write.

Commit a pending acquisition to the A&D book — the point of no return. Dry-run by default; pass confirm:true to commit. Write.

Delete a PENDING (uncommitted) acquisition draft. Dry-run by default; pass confirm:true. Destructive write.

Remove an item from a pending acquisition. Dry-run by default; pass confirm:true. Destructive write.

Search disposition records (firearms leaving inventory: sales, FFL transfers, theft/loss, destroyed). Filter by type, TTSN/OTSN, PO/invoice/tracking, recipient contact, item. Read-only.

Retrieve a single disposition by FastBound GUID id or your externalId. Read-only.

List the items on a disposition. Read-only.

List dispositions that have an associated ATF Form 4473. Read-only.

Record a disposition and commit it in one step (sale, FFL transfer, etc.). Items reference firearms already in inventory by GUID. For FFL transfers set requestType=Regular and otherTransfereeEmails; FastBound may auto-create the receiving FFL's acquisition (reported back via headers). Commits a regulated record: dry-run by default, pass confirm:true. Write.

Create a PENDING (uncommitted) disposition draft. No ATF effect until committed, so it executes directly. Add items with add_disposition_items, then finalise with commit_disposition. Write.

Add inventory items (by GUID, optionally with a price) to a pending disposition. Executes directly. Write.

Edit header fields on a PENDING disposition (type, date, note, TTSN/OTSN, PO/invoice/tracking, theft-loss/destroyed details). Read-merge-write so unspecified fields keep their values. Dry-run by default; pass confirm:true. Write.

Set the sale price of an item on a pending disposition. Executes directly. Write.

Assign an existing recipient/buyer contact to a pending disposition. Executes directly. Write.

Remove an item from a pending disposition by its inventory item GUID. Dry-run by default; pass confirm:true. Write.

Commit a pending disposition to the A&D book — the point of no return. May trigger a Multiple Sale report and, for FFL transfers, auto-create the recipient's acquisition (reported via headers). Dry-run by default; pass confirm:true. Write.

Lock a disposition to prevent further edits. Dry-run by default; pass confirm:true. Write.

Record and commit a theft/loss disposition for inventory items. Provide discovery date and incident numbers. Dry-run by default; pass confirm:true. Write.

Record and commit a destroyed disposition for inventory items. Provide destruction date, description, and witnesses. Dry-run by default; pass confirm:true. Write.

Record and commit an NFA disposition for inventory items. Dry-run by default; pass confirm:true. Write.

Delete a PENDING (uncommitted) disposition draft. Dry-run by default; pass confirm:true. Destructive write.

Search contacts (individuals, organizations, and FFLs). Filter by name, FFL number, trade name, or organization name. Read-only.

Retrieve a single contact by FastBound GUID id or your externalId. Read-only.

Create a contact (FFL, organization, or individual). Provide fflNumber for an FFL, organizationName for an org, or first/last name for an individual, plus premise address fields. Executes directly (a contact is not an A&D record). If FastBound matches an existing contact it is reported via headers. Write.

Edit fields on an existing contact. Read-merge-write so unspecified fields keep their current values (including the required status). Dry-run by default (preview shows the merged body); pass confirm:true. Write.

Add, update, or delete a license on a contact. For add provide type+number; for update/delete provide licenseId. Executes directly. Write.

Merge two duplicate contacts: keep winningContactId, discard losingContactId (its references move to the winner). Dry-run by default; pass confirm:true. Destructive write.

Generate and download the A&D bound book export. Requires an auditUser email (recorded by FastBound). Returns the file base64-encoded (large exports are summarised instead). Read.

Download a completed ATF Form 4473 PDF by its id. Returns the file base64-encoded. Read.

Download an attachment file by its id. Returns the file base64-encoded. Read.

Download a Multiple Sale report attachment (ATF Form 3310.4/5300.9) by report id and attachment id. Returns the file base64-encoded. Read.

List available webhook event types, get a webhook, or create/update/delete a webhook subscription. action=list_events|get reads; create|update|delete are writes (require FASTBOUND_ALLOW_WRITES). For create provide name, url, and events.

Mark a list of serial numbers as physically verified during a cycle count, optionally updating their location. Write.