Api Docs

Introduction

Welcome to the RTO Transparency Platform API. Our API provides access to a wealth of data regarding Registered Training Organisations, performance metrics, licensing pathways, and more. This documentation will guide you through authentication, available endpoints, request/response formats, and usage limits.

Authentication

All API requests must be authenticated using an API key. You can generate and manage your API keys from your account settings page (coming soon).

// Example: Including API Key in Header
fetch('https://api.rtotransparency.com.au/v1/rtos', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})

Rate Limiting

To ensure fair usage, our API is rate-limited. The standard rate limit is 100 requests per minute per API key. Please check the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers in API responses for current status.

Endpoints

GET /v1/rtos

Retrieves a list of RTOs. Supports pagination and filtering.

Query Parameters:

• page (integer, optional): Page number for pagination. Default: 1.
• limit (integer, optional): Number of results per page. Default: 20, Max: 100.
• state (string, optional): Filter by state (e.g., "NSW", "VIC").
• course_name (string, optional): Filter by course name (partial match).

Example Request:

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.rtotransparency.com.au/v1/rtos?state=NSW&limit=5"

GET /v1/rtos/{rto_id}

Retrieves detailed information for a specific RTO.

Example Request:

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.rtotransparency.com.au/v1/rtos/12345"

GET /v1/licensing-pathways

Retrieves licensing pathway information.

Query Parameters:

• state (string, optional): Filter by state. If not provided, returns for all states.

More Endpoints Coming Soon

We are actively working on expanding our API to include:

• Performance Scores
• AI Analysis Tools (Review Synthesis, Comparative Analysis)
• Compliance Data

Stay tuned for updates!