Calculate Pay (Audited)

POST /api/v1/calculate-pay-audited

Request body

Identical to Calculate Pay. Same fields, same validation.

Response

Returns a pay_result (same as Calculate Pay response) plus a full audit payload:

Field	Type	Description
pay_result	object	Full Calculate Pay response
audit_id	string	Unique identifier for this audit record
calculated_at	string (datetime)	Timestamp of calculation
engine_version	string	Engine version used
version	object	Award version resolution details
rate	object	Rate derivation audit with all intermediate values
rules_considered	array	All rules evaluated (including those not applied)
rules_applied	array	Rules that were used in the final calculation
rounding_applied	array	Rounding operations performed
day_classification	string	How the day was classified (e.g. weekday, saturday, public_holiday)
rate_path	string	Rate calculation path taken
pay_mode	string	Pay calculation mode used

rules_considered / rules_applied items

Field	Type	Description
rule_table	string	Database table the rule came from
rule_id	integer	Rule record ID
rule_description	string	Human-readable rule description
priority	integer	Rule priority in conflict resolution
status	string	applied, skipped, or superseded
reason	string	Why the rule was applied/skipped
superseded_by	string or null	Which rule took precedence (if superseded)
source_clauses	array	Award clause references

Use cases

• Compliance audits — prove exactly which award rules produced a pay figure
• Dispute resolution — show the precedence chain when multiple rules applied
• Integration testing — verify your system matches the engine’s rule-by-rule logic

Example request

curl -X POST /api/v1/calculate-pay-audited \
  -H "Authorization: Bearer ak_KEY:sk_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "award_code": "MA000009",
    "classification_code": "HI1",
    "employment_type": "casual",
    "work_date": "2026-03-21",
    "start_time": "18:00",
    "end_time": "23:00",
    "unpaid_break_minutes": 0
  }'

Errors

Same as Calculate Pay.