Retrieve bill | Bomgrove

Retrieve the latest Bomgrove bill or a specific saved revision. Returns the original component values, revision differences, and leaf totals for one root assembly. Retrieval does not create a revision.

curl https://api.bomgrove.com/v1/get_bill \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"bill_id":"your bill id"}'

Input

Field	Type	Description
`bill_id` (required)	string	Bill ID returned by Create bill.
`revision_id`	string	Revision ID. Omit to retrieve the latest revision.

Output

Field	Type	Description
`bill_id` (required)	string	Stable bill ID.
`revision_id` (required)	string	Immutable revision ID.
`revision_number` (required)	integer
`previous_revision_id` (required)	string	Empty on the first revision.
`name` (required)	string	Bill name.
`root_part_number` (required)	string	Top-level assembly part number.
`note` (required)	string
`created_at` (required)	string	Revision creation time in UTC.
`components` (required)	array	Complete BOM as assembly relationships. Each row is one part per parent. A part with children is a subassembly. All parents must connect to the root. Repeated part numbers must have the same description and unit. An empty list is allowed.
`totals` (required)	array
`changes` (required)	array
`summary` (required)	string	Relationship counts and any bill name change.