CALC Labor Rates Data Dictionary¶
This document describes the fields available in the CALC labor category rate endpoints (/api/idvs/{key}/lcats/, /api/entities/{uei}/lcats/). For filtering, ordering, and pagination, see the CALC Labor Rates API Reference.
Overview¶
CALC (Contract Awarded Labor Category) rates are labor category pricing records sourced from the GSA CALC API. Each record represents a single labor category rate on a GSA MAS (Multiple Award Schedule) contract. The dataset contains approximately 238,000 records.
Primary identifier: uuid (deterministic, derived from the external CALC record ID).
Update Frequency¶
CALC labor rate data is refreshed daily from the GSA CALC API.
Fields¶
| Field | Type | Description | Source |
|---|---|---|---|
uuid | UUID | Deterministic primary key (derived from external CALC ID). | CALC / Tango |
labor_category | String | Labor category title. | CALC |
current_price | Decimal | Current hourly rate. | CALC |
education_level | String | Required education level. | CALC |
min_years_experience | Integer | Minimum years of experience required. | CALC |
experience_range | String | Experience range description (e.g., "5-7 years"). | CALC |
security_clearance | String | Security clearance requirement. | CALC |
worksite | String | Work location type. | CALC |
sin | String | Special Item Number. | CALC |
category | String | Service category. | CALC |
subcategory | String | Service subcategory. | CALC |
schedule | String | GSA schedule name. | CALC |
contract_start | Date | Contract period start date. | CALC |
contract_end | Date | Contract period end date. | CALC |
Expansions (via shape)¶
idv-- Linked IDV details:key,piid,award_daterecipient-- Entity details via IDV recipient linkage:uei,display_namebusiness_size-- Business size as structuredcode/description(e.g.,{"code": "S", "description": "Small Business"})
The idv and recipient expansions require Pro tier access. The business_size expansion is available on all tiers.
Data Sources¶
- GSA CALC -- Contract Awarded Labor Category API. Provides labor category pricing data from GSA MAS contracts.
Usage Notes¶
- Use
uuidfor unique identification. The UUID is deterministic and stable across data refreshes for the same CALC record. - IDV linkage is best-effort. The
idvexpansion is populated when Tango can match the CALC contract number to an IDV PIID in the awards dataset. - Recipient is derived from the IDV. The
recipientexpansion comes from the linked IDV's recipient entity, not directly from CALC data. - These are nested endpoints. Access rates via
/api/idvs/{key}/lcats/or/api/entities/{uei}/lcats/-- there is no top-level route. - Pro tier required. Both the endpoints and the
idv/recipientexpansions require Pro tier access or above.