Integration
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 field | Ratio field | What happens |
|---|---|---|
| Employee / educator record | Staff record | Matched on work email first, then full name. Existing staff are updated, not duplicated. |
| Employee ID or payroll number | Contract number | Kept on the staff record and printed on the assessor evidence pack. |
| Position / role title | Role | Free text. Used for grouping the roster and for first aid coverage counts. |
| Qualification or certificate name | Credential type | Mapped to Ratio's credential catalogue (WWCC/Blue Card, first aid, anaphylaxis, asthma, CPR, qualification, police check). |
| Card / certificate number | Credential number | Stored as entered. Ratio records it; it does not verify it against a register. |
| Issue and expiry dates | Issued / expires | Expiry drives the live 90/30/7-day status at render time. Missing expiry shows as incomplete. |
| Attached certificate file | Evidence file | Images and PDFs up to 15 MB are stored against the credential. |
| Site / centre | Centre | Staff 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.