Getting Started

Three things you need to start making API requests.

Base URL

https://api.novocove.com.au/v1

All API requests are made to this base endpoint.

Authentication

Bearer JWT

Pass your API token in the Authorization header.

Content-Type

application/json

All request and response bodies are JSON.

Core Resources

Four primary endpoints to manage your compliance data.

Staff

/staff

Create, read, update, and delete staff records. Manage profiles, roles, and site assignments.

GETPOSTPATCHDELETE

Certifications

/certifications

Manage certifications, upload evidence, and track expiry dates with automatic RAG status.

GETPOSTPATCHDELETE

Alerts

/alerts

Retrieve and configure compliance alerts. Set custom notification thresholds and recipients.

GETPOST

Reports

/reports

Generate and export compliance reports in PDF, CSV, or JSON format. ACECQA and ACQSC ready.

GETPOST

Try It Out

A quick example to get you fetching staff data in minutes.

Request
curl -X GET \
  https://api.novocove.com.au/v1/staff \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "Centre A",
    "compliance_status": "green",
    "per_page": 20
  }'
Response
200 OK
{
  "data": [
    {
      "id": "st_abc123",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "[email protected]",
      "role": "Early Childhood Educator",
      "site": "Centre A",
      "compliance_status": "green",
      "certifications_count": 5,
      "alerts_count": 0,
      "created_at": "2025-01-15T09:30:00Z",
      "updated_at": "2025-06-01T14:22:00Z"
    },
    {
      "id": "st_def456",
      "first_name": "Michael",
      "last_name": "Chen",
      "email": "[email protected]",
      "role": "Centre Director",
      "site": "Centre A",
      "compliance_status": "amber",
      "certifications_count": 4,
      "alerts_count": 1,
      "created_at": "2024-08-20T11:00:00Z",
      "updated_at": "2025-05-28T09:15:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 47,
    "total_pages": 3
  },
  "links": {
    "self": "https://api.novocove.com.au/v1/staff?page=1",
    "next": "https://api.novocove.com.au/v1/staff?page=2",
    "last": "https://api.novocove.com.au/v1/staff?page=3"
  }
}

Rate Limits

PlanRequests/MinBest For
Starter100/minSuitable for small centres
Professional500/minFor growing providers
Enterprise2,000/minFor large organisations

Webhooks

Subscribe to real-time events and get notified when important compliance events occur in your organisation.

cert.createdTriggered when a new certification is added.
cert.updatedTriggered when a certification is modified.
cert.expiringTriggered when a certification approaches expiry.
staff.addedTriggered when a new staff member is added.
alert.triggeredTriggered when a compliance alert fires.
report.generatedTriggered when a report is ready for download.

Official SDKs Coming Soon

We're building official SDKs to make integration even faster. Here's what's on the roadmap:

JavaScriptPythonPHP

Expected release: Q3 2026

Start Building Today

Get API access with a Professional or Enterprise plan. Join the waitlist to be first in line.

Join the Waitlist