Integration

Kangarootime logo

Kangarootime

Two-way: roster in, compliance status out.

The API field guide for keeping Kangarootime staff and Ratio credentials in step, including across multiple sites in a group.

What comes into Ratio

  • Staff records with site assignment
  • Roles and employee numbers
  • Credential records with expiry dates

What Ratio sends back

  • Per-site and group-wide compliance summary
  • Staff and credential status
  • Alerts feed

How the fields map

Each record from Kangarootime lands on a specific field in Ratio. Status is calculated from the expiry date every time a page or report is opened.

Kangarootime fieldRatio fieldWhat happens
Employee / educator recordStaff recordMatched on work email first, then full name. Existing staff are updated, not duplicated.
Employee ID or payroll numberContract numberKept on the staff record and printed on the assessor evidence pack.
Position / role titleRoleFree text. Used for grouping the roster and for first aid coverage counts.
Qualification or certificate nameCredential typeMapped to Ratio's credential catalogue (WWCC/Blue Card, first aid, anaphylaxis, asthma, CPR, qualification, police check).
Card / certificate numberCredential numberStored as entered. Ratio records it; it does not verify it against a register.
Issue and expiry datesIssued / expiresExpiry drives the live 90/30/7-day status at render time. Missing expiry shows as incomplete.
Attached certificate fileEvidence fileImages and PDFs up to 15 MB are stored against the credential.
Site / centreCentreStaff can belong to more than one centre in a group.

Webhooks you can subscribe to

  • credential.expiring
  • credential.expired
  • staff.updated

Every delivery is signed so your system can verify it came from Ratio.

Worth knowing

  • This page is an integration guide for Ratio's open REST API and webhooks — not a turnkey connector installed with one click. Your platform contact or IT person wires it up once.
  • Shared staff working across sites are stored once and linked to each centre.
  • Site names must match your Ratio centre names, or the sync asks you to map them.