Australia Wide First Aid agent API

A public, read-only JSON API for AI agents helping someone find an Australia Wide First Aid course: the courses, the training venues, upcoming sessions and the site's FAQs. It needs no credentials or API key, sets no cookies and changes nothing. Call it with a plain GET.

• OpenAPI 3.1 description: /agent/openapi.json (also at /openapi.json)
• API catalog (RFC 9727): /.well-known/api-catalog
• Server: https://www.australiawidefirstaid.com
• Markdown version: /agent/docs.md

Authentication

None. Every endpoint is public and read-only: there is no API key, account or sign-up, and a request needs no Authorization header and no cookie. This request, sent exactly as written, answers 200 with JSON:

curl https://www.australiawidefirstaid.com/agent/courses

The site's statement for agents is auth.md.

Booking

The API doesn't book. When the person has chosen a session, send them to its booking_page. They finish on the enrolment site, where they enter their own details and pay there. An agent never enters payment details.

MCP server

The same API is a public MCP server at https://www.australiawidefirstaid.com/mcp (Streamable HTTP). It needs no sign-in, API key or install. To use it from an assistant, add it as a custom connector with that URL: in Claude, for example, under Settings, Connectors, Add custom connector. Its server card is at /mcp/server-card (also /.well-known/mcp/server-card.json).

Each tool takes the endpoint's parameters as arguments and returns the same JSON the endpoint does; an endpoint error comes back as a tool error with the same {"error": "..."} body. The tools never use the caller's IP address, so search_nearby_sessions needs near: ask the person for their postcode or suburb.

start_booking doesn't book. It takes a session_id from a search and returns a link, https://www.australiawidefirstaid.com/book/<session_id>, for one place. The person opens it and completes the booking themselves on the enrolment site, where they enter their own details and pay. For a group, book each person separately or use the corporate enquiry page.

A2A agent

The same reads are an Agent2Agent (A2A) agent at https://www.australiawidefirstaid.com/a2a: JSON-RPC 2.0 SendMessage (A2A 1.0) or message/send (0.3), no sign-in. Its agent card is at /.well-known/agent-card.json. Send a message whose data part names a skill (the tool names above, without start_booking) and its arguments, named as the endpoint's parameters, for example {"skill":"search_nearby_sessions","course":"HLTAID011","near":"4000"}. The reply is a completed task whose artifact holds the endpoint's JSON as a data part and a one-line text part. An endpoint error is the same {"error": "..."} body in a completed task, or a failed task when an upstream service failed. Free text isn't interpreted: a message without a known skill gets a list of the skills and examples. The agent never uses the caller's IP address, stores no tasks, doesn't stream and doesn't book.

Errors

Every error is JSON {"error": "..."} saying what to call or pass instead.

Endpoints

curl https://www.australiawidefirstaid.com/agent/courses

{
  "courses": [
    {
      "id": "first-aid",
      "code": "HLTAID011",
      "name": "Provide First Aid",
      "official_name": "Provide First Aid (Includes CPR)",
      "summary": "Comprehensive first aid training including CPR, emergency response and casualty management.",
      "duration": [
        "This is a blended course with self-paced online learning (e-Learning) and face-to-face training. Before attending the face-to-face training, students will need to complete their e-Learning which can be done in one sitting or over several sessions."
      ],
      "delivery": [
        "e-Learning plus face-to-face classroom training and assessment"
      ],
      "renewal": "Renew every 3 years",
      "url": "https://www.australiawidefirstaid.com/courses/first-aid"
    }
  ]
}

curl https://www.australiawidefirstaid.com/agent/courses/first-aid

{
  "id": "first-aid",
  "code": "HLTAID011",
  "name": "Provide First Aid",
  "official_name": "Provide First Aid (Includes CPR)",
  "headline": "HLTAID011 Provide First Aid is the minimum requirement for workplace first aid compliance.",
  "key_points": [
    "HLTAID011 Provide First Aid — a nationally recognised certification"
  ],
  "renewal": "Renew every 3 years",
  "certificate": [
    "A PDF Statement of Attainment in HLTAID011 Provide First Aid will be emailed to you the same day as your successful completion of the training and assessment (and provided that student has provided a verified USI and completed all required assessment for the course)."
  ],
  "url": "https://www.australiawidefirstaid.com/courses/first-aid"
}

curl 'https://www.australiawidefirstaid.com/agent/locations?state=QLD'

{
  "locations": [
    {
      "id": "beaudesert",
      "name": "Beaudesert",
      "state": "QLD",
      "suburb": "Beaudesert",
      "postcode": "4285"
    }
  ]
}

curl 'https://www.australiawidefirstaid.com/agent/sessions?course=first-aid&location=brisbane-cbd'

{
  "sessions": [
    {
      "session_id": "2064651",
      "course": "first-aid",
      "course_name": "HLTAID011 Provide first aid + HLTAID009 Provide cardiopulmonary resuscitation",
      "date": "2026-11-03",
      "date_display": "Tuesday 3 November",
      "time": "9:00 am - 1:00 pm",
      "seats": "5+",
      "venue": {
        "id": "brisbane-cbd",
        "name": "Brisbane CBD",
        "state": "QLD"
      },
      "booking_page": "https://www.australiawidefirstaid.com/?course=92956&location=brisbane-cbd#find-course"
    }
  ]
}

curl 'https://www.australiawidefirstaid.com/agent/nearby-sessions?course=cpr&near=4510'

{
  "near": {
    "postcode": "4510",
    "state": "QLD",
    "suburb": "Caboolture"
  },
  "venues_searched": [
    {
      "id": "caboolture",
      "name": "Caboolture",
      "distance_km": 4
    }
  ],
  "sessions": [
    {
      "session_id": "2065420",
      "course": "cpr",
      "course_name": "HLTAID009 Provide cardiopulmonary resuscitation",
      "date": "2026-11-03",
      "date_display": "Tuesday 3 November",
      "time": "9:00 am - 11:00 am",
      "seats": "Almost sold out!",
      "venue": {
        "id": "north-lakes",
        "name": "North Lakes",
        "state": "QLD",
        "distance_km": 19
      },
      "booking_page": "https://www.australiawidefirstaid.com/?course=92955&location=north-lakes#find-course"
    }
  ]
}

curl 'https://www.australiawidefirstaid.com/agent/faqs?topic=cpr'

{
  "faqs": [
    {
      "question": "What first aid course do I need for work in Australia?",
      "answer": "Most workplaces require HLTAID011 Provide First Aid (includes CPR). Some roles also require HLTAID009 Provide CPR refreshed yearly, and childcare roles require HLTAID012 First Aid in an Education and Care Setting."
    }
  ]
}