DIBBS Data Dictionary¶
This document describes the fields available on the DIBBS API endpoints (/api/dibbs/rfqs/, /api/dibbs/rfps/, /api/dibbs/awards/). For filtering, ordering, and pagination, see the DIBBS API Reference.
Overview¶
DIBBS is the DLA Internet Bid Board System — the Defense Logistics Agency's board for small-purchase requests for quote (RFQs), larger solicitations (RFP/IFB), and awards. Every record is scoped to a National Stock Number (NSN) or manufacturer part number. All three resources are keyed by a synthetic uuid and carry an organization relation (always DLA).
Note: The full field set on each resource is available via the shape query parameter. See Response Shaping for details.
Open/closed is derived¶
RFQs and solicitations expose an is_open boolean and an open filter, both derived at query time from the record's closing date (return_by_date for RFQs, closes_date for solicitations). A passed or missing date is not open. Because it is derived, a record simply reaching its closing date does not change the stored row (and does not fire a webhook alert). Awards have no open/closed lifecycle.
Awards are line items¶
A DIBBS award record is one line item, not a whole award. total_contract_price is the order's total, replicated on every line item of that order — never SUM() it across records. To total spend, count each order once (dedupe by award_number + delivery_order_number). See the API reference warning.
RFQ fields (/api/dibbs/rfqs/)¶
| Field | Type | Description | Source |
|---|---|---|---|
uuid | String (UUID) | Synthetic primary key; the detail lookup value. | Tango |
solicitation | String | DLA solicitation number, e.g. SPE1C126Q0337. | DIBBS |
solicitation_formatted | String | Formatted solicitation number (detail default only). | DIBBS |
purchase_request | String | Purchase request number (second half of the natural key). | DIBBS |
nsn | String | National Stock Number. | DIBBS |
part_number | String | Manufacturer part number. | DIBBS |
nomenclature | String | Item nomenclature / description. | DIBBS |
quantity | Integer | Quantity requested. | DIBBS |
unit_of_issue | String | Unit of issue. | DIBBS |
set_aside | String | Set-aside flag (Y / N; other values normalize to null). | DIBBS |
status_code | String | 11-character composite DIBBS status code, e.g. DLK00L1N000. | DIBBS |
return_by_date | Date | RFQ close date. Drives is_open. | DIBBS |
issue_date | Date | DIBBS archive date (newest-wins arbitration signal). | DIBBS |
is_open | Boolean | Computed: whether the RFQ is still accepting quotes today. | Tango |
document_url | String | Link to the RFQ document. | DIBBS |
organization | Object | Buying organization (DLA), as the canonical 7-key office payload. Detail default only. | Tango |
Solicitation (RFP) fields (/api/dibbs/rfps/)¶
| Field | Type | Description | Source |
|---|---|---|---|
uuid | String (UUID) | Synthetic primary key; the detail lookup value. | Tango |
solicitation | String | Solicitation number (null on pending NEW postings). | DIBBS |
nsn | String | National Stock Number. | DIBBS |
part_number | String | Manufacturer part number. | DIBBS |
nomenclature | String | Item nomenclature / description. | DIBBS |
buyer_code | String | DLA buyer code. | DIBBS |
issued_date | Date | DIBBS posting date (newest-wins arbitration signal). | DIBBS |
closes_date | Date | Solicitation close date. Drives is_open. | DIBBS |
is_open | Boolean | Computed: whether the solicitation is still accepting offers today. | Tango |
document_url | String | Link to the solicitation document. | DIBBS |
tech_docs_url | String | DLA TDMT technical-data-package link, when present. | DIBBS |
organization | Object | Buying organization (DLA), as the canonical 7-key office payload. Detail default only. | Tango |
Award fields (/api/dibbs/awards/)¶
| Field | Type | Description | Source |
|---|---|---|---|
uuid | String (UUID) | Synthetic primary key; the detail lookup value. | Tango |
award_number | String | Award (order) number. Order-scoped. | DIBBS |
delivery_order_number | String | Delivery-order number (null on basic awards). Order-scoped. | DIBBS |
delivery_order_counter | String | Delivery-order counter (null on basic awards). Order-scoped. | DIBBS |
nsn | String | National Stock Number (line-item-scoped; mutually exclusive with part_number). | DIBBS |
part_number | String | Manufacturer part number (line-item-scoped). | DIBBS |
purchase_request | String | Purchase request number (line-item-scoped). | DIBBS |
nomenclature | String | Item nomenclature / description. | DIBBS |
awardee_cage | String | Awardee CAGE code (populated on every award row). Order-scoped. | DIBBS |
total_contract_price | Decimal | Order total, replicated per line item — never summable across rows. Null on ~3.5% of rows. | DIBBS |
total_contract_price_text | String | Raw price cell verbatim (e.g. See Award Doc) when non-numeric. | DIBBS |
award_date | Date | Award date. | DIBBS |
posted_date | Date | DIBBS posting date (newest-wins arbitration signal). | DIBBS |
last_mod_posting_date | Date | Last modification posting date (detail default only). | DIBBS |
solicitation | String | Solicitation number (present on ~35% of awards). Order-scoped. | DIBBS |
awardee | Object | Resolved Tango entity (uei, cage_code, legal_business_name); null when the CAGE is unresolved. | Tango |
organization | Object | Buying organization (DLA), as the canonical 7-key office payload. Detail default only. | Tango |
Expansions (via shape)¶
organization(*)(all three) →organization_id,office_code,office_name,agency_code,agency_name,department_code,department_name— always DLA.awardee(*)(awards only) →uei,cage_code,legal_business_namefrom the resolved entity.
Data Sources¶
- DIBBS — the DLA Internet Bid Board System (RFQ, solicitation, and award records).
- Tango —
uuid,is_open, the resolvedorganizationandawardee, and arbitration/normalization.
Usage Notes¶
- Detail lookup is by
uuidon all three resources. searchcovers nomenclature, NSN, part number, and solicitation number (awards also include award number).- Alerts cover RFQs and solicitations (
dibbs_rfq,dibbs_rfpquery types); awards are not alertable. See Webhooks.