Compare Awards

POST /api/v1/compare-awards

Request body

Field	Type	Required	Default	Description
award_a	string	Yes	—	First award code (e.g. MA000009)
award_b	string	Yes	—	Second award code (e.g. MA000004)
classification_a	string	No	—	Classification from award A (e.g. HI1)
classification_b	string	No	—	Classification from award B (e.g. RE3)
worker_type	string	No	non_shiftworker	Worker type
employment_type	string	No	full_time	Employment type

Response

Field	Type	Description
award_a_code / award_b_code	string	Award codes compared
award_a_name / award_b_name	string	Award names
rule_comparisons	array	Side-by-side rule comparison items
key_differences	array	Summary of significant differences
key_similarities	array	Summary of similarities
summary	string	Plain-English comparison summary
deterministic_comparison	boolean	Always true — data from normalised rules, not AI

rule_comparisons items

Each item compares one rule topic between the two awards:

Field	Type	Description
topic	string	Rule topic identifier (e.g. base_pay, saturday_penalty)
topic_label	string	Human-readable label
award_a_value / award_b_value	string	Formatted values for display
award_a_raw / award_b_raw	number/string	Raw values for programmatic comparison
difference	string	Description of difference
difference_direction	string	a_higher, b_higher, equal, or incomparable

Topics compared

Topic	What’s Compared
base_pay	Weekly rate for selected classifications
ordinary_hours	Standard hours per week
casual_loading	Casual loading percentage
saturday_penalty	Saturday penalty multiplier
sunday_penalty	Sunday penalty multiplier
public_holiday_penalty	Public holiday penalty multiplier
overtime_split	OT threshold (hours at 150% before 200%)

Example request

curl -X POST /api/v1/compare-awards \
  -H "Authorization: Bearer ak_KEY:sk_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "award_a": "MA000009",
    "award_b": "MA000004",
    "classification_a": "HI1",
    "classification_b": "RE1"
  }'