{
  "openapi": "3.1.0",
  "info": {
    "title": "ausdata.io",
    "version": "1.0.0",
    "description": "One API for Australian government data. Nine sources (ABS, RBA, ATO, ASIC, APRA, AIHW, WGEA, AEMO, BOM) behind one bearer token and a consistent JSON envelope. Free tier: 500 calls per month, no credit card.",
    "contact": {
      "name": "ausdata.io",
      "url": "https://ausdata.io"
    },
    "license": {
      "name": "CC-BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    }
  },
  "servers": [
    {
      "url": "https://api.ausdata.io",
      "description": "Production"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key"
      }
    }
  },
  "tags": [
    {
      "name": "Discovery",
      "description": "Find datasets"
    },
    {
      "name": "Meta",
      "description": "Account and health"
    },
    {
      "name": "Macro",
      "description": "Macroeconomic indicators"
    },
    {
      "name": "Markets",
      "description": "Financial markets"
    },
    {
      "name": "Regulators",
      "description": "ASIC, APRA registers"
    },
    {
      "name": "Housing",
      "description": "Property and housing finance"
    },
    {
      "name": "Energy",
      "description": "NEM and energy markets"
    },
    {
      "name": "Labour",
      "description": "Employment and wages"
    },
    {
      "name": "Trade",
      "description": "Imports, exports, tenders"
    },
    {
      "name": "Social",
      "description": "Health, charity, equity"
    }
  ],
  "paths": {
    "/v1/data/asic/banned-persons": {
      "get": {
        "operationId": "asicBannedPersons",
        "summary": "ASIC Banned and Disqualified Persons",
        "description": "Query the ASIC Banned and Disqualified Persons register as a clean JSON REST API. Returns each banned individual with disqualification dates, reasons, and the regulator action. Updated daily from the official ASIC register. One bearer token, consistent envelope, no scraping or HTML parsing required.",
        "tags": [
          "Regulators",
          "ASIC"
        ],
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NSW"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "10"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ASIC Banned and Disqualified Persons rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "name": "Example Person",
                      "state": "NSW",
                      "ban_start": "2025-03-12",
                      "ban_end": "2030-03-12",
                      "reason": "Failure to comply with financial services laws",
                      "action_type": "Banning order"
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/asic/banned-persons",
                    "source": {
                      "name": "ASIC",
                      "url": "https://asic.gov.au/",
                      "attribution": "(c) ASIC, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/asic/afs-licensees": {
      "get": {
        "operationId": "asicAfsLicensees",
        "summary": "ASIC AFS Licensees",
        "description": "The current Australian Financial Services (AFS) licensee register as JSON. Each row returns licence number, holder name, ABN, authorisation date, and authorised activities. Sourced from the ASIC professional registers and refreshed weekly. Validate financial counterparties or build licence-status checks without scraping ASIC Connect.",
        "tags": [
          "Regulators",
          "ASIC"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "10"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ASIC AFS Licensees rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "afsl": "123456",
                      "name": "Example Advisers Pty Ltd",
                      "abn": "12345678901",
                      "authorised_from": "2014-08-01",
                      "authorisations": [
                        "Financial product advice",
                        "Dealing"
                      ]
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/asic/afs-licensees",
                    "source": {
                      "name": "ASIC",
                      "url": "https://asic.gov.au/",
                      "attribution": "(c) ASIC, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/asic/companies": {
      "get": {
        "operationId": "asicCompanyRegister",
        "summary": "ASIC Company Register",
        "description": "Look up registered Australian companies by ACN, ABN, or name. Returns company status, type, registration date, and registered office state. Sourced from the ASIC company register and refreshed daily. Use it to verify counterparties, enrich CRM records, or build KYC pipelines without scraping ASIC Connect.",
        "tags": [
          "Regulators",
          "ASIC"
        ],
        "parameters": [
          {
            "name": "acn",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "004085616"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ASIC Company Register rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "acn": "004085616",
                      "name": "Example Holdings Ltd",
                      "status": "Registered",
                      "type": "APUB",
                      "registered": "1948-09-22",
                      "state": "VIC"
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/asic/companies",
                    "source": {
                      "name": "ASIC",
                      "url": "https://asic.gov.au/",
                      "attribution": "(c) ASIC, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/apra/adi-list": {
      "get": {
        "operationId": "apraAuthorisedDepositInstitutions",
        "summary": "APRA Authorised Deposit-taking Institutions",
        "description": "The current list of APRA-authorised deposit-taking institutions (ADIs) as JSON. Covers major banks, mutuals, credit unions, and foreign bank branches with licence status, institution type, and ABN. Sourced from the official APRA register and refreshed weekly. Use it to validate banking counterparties or build licence-status checks.",
        "tags": [
          "Regulators",
          "APRA"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "APRA Authorised Deposit-taking Institutions rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "name": "Example Bank Ltd",
                      "abn": "12345678901",
                      "type": "Australian-owned bank",
                      "status": "Authorised",
                      "licence_date": "2010-07-01"
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/apra/adi-list",
                    "source": {
                      "name": "APRA",
                      "url": "https://www.apra.gov.au/register-of-authorised-deposit-taking-institutions",
                      "attribution": "(c) APRA, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/apra/monthly-banking": {
      "get": {
        "operationId": "apraMonthlyBankingStats",
        "summary": "APRA Monthly Banking Statistics",
        "description": "APRA Monthly Authorised Deposit-taking Institution Statistics as JSON. Bank-level deposits, housing loans, and business credit by month. Sourced from the APRA MADIS publication and refreshed each release. Skip the Excel workbook and query bank balance-sheet trends directly with a bearer token.",
        "tags": [
          "Regulators",
          "APRA"
        ],
        "parameters": [
          {
            "name": "bank",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Example Bank Ltd"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "APRA Monthly Banking Statistics rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-04",
                      "bank": "Example Bank Ltd",
                      "deposits_aud_m": 412300,
                      "housing_loans_aud_m": 358200,
                      "business_loans_aud_m": 92400
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/apra/monthly-banking",
                    "source": {
                      "name": "APRA",
                      "url": "https://www.apra.gov.au/monthly-authorised-deposit-taking-institution-statistics",
                      "attribution": "(c) APRA, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/apra/super-performance": {
      "get": {
        "operationId": "apraSuperannuationFunds",
        "summary": "APRA Superannuation Fund Performance",
        "description": "APRA-regulated superannuation fund performance as JSON. Net returns, fees, and assets by fund and investment option. Sourced from APRA's quarterly super statistics. Compare MySuper products or feed fund-selection tools without parsing the APRA workbook.",
        "tags": [
          "Regulators",
          "APRA"
        ],
        "parameters": [
          {
            "name": "option",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "MySuper"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "10"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "APRA Superannuation Fund Performance rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "fund": "Example Super",
                      "option": "MySuper Balanced",
                      "period": "2025-Q1",
                      "net_return_pct": 8.4,
                      "fees_pct": 0.85,
                      "assets_aud_m": 12400
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/apra/super-performance",
                    "source": {
                      "name": "APRA",
                      "url": "https://www.apra.gov.au/quarterly-superannuation-statistics",
                      "attribution": "(c) APRA, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/real-cash-rate": {
      "get": {
        "operationId": "rbaCashRate",
        "summary": "RBA Cash Rate Target",
        "description": "Get the current RBA cash rate target and the inflation-adjusted real cash rate in one JSON call. Pulls the nominal cash rate from the RBA F1 statistical table and subtracts the latest trimmed-mean CPI from the ABS. No XLS parsing, no series-ID lookups. Updated after every RBA board meeting.",
        "tags": [
          "Macro",
          "RBA"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "RBA Cash Rate Target rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": {
                    "cash_rate_pct": 4.35,
                    "cash_rate_period": "2025-05-20",
                    "real_cash_rate_pct": 1.25,
                    "trimmed_mean_cpi_pct": 3.1
                  },
                  "meta": {
                    "endpoint": "/v1/real-cash-rate",
                    "sources": [
                      {
                        "name": "RBA",
                        "url": "https://www.rba.gov.au/statistics/cash-rate/",
                        "attribution": "(c) Reserve Bank of Australia, CC-BY 4.0"
                      }
                    ],
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/rba/exchange-rates": {
      "get": {
        "operationId": "rbaExchangeRates",
        "summary": "RBA Exchange Rates",
        "description": "Daily Australian Dollar exchange rates as JSON. Bilateral rates against USD, EUR, GBP, JPY, CNY and the Trade-Weighted Index. Sourced from the RBA F11 statistical table and refreshed each Sydney close. Skip the CSV download and pull AUD FX into apps, dashboards, or backtests directly.",
        "tags": [
          "Markets",
          "RBA"
        ],
        "parameters": [
          {
            "name": "pair",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "USD"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "30"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "RBA Exchange Rates rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "date": "2025-05-20",
                      "pair": "USD",
                      "rate": 0.6612
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/rba/exchange-rates",
                    "source": {
                      "name": "RBA",
                      "url": "https://www.rba.gov.au/statistics/frequency/exchange-rates.html",
                      "attribution": "(c) RBA, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/rba/household-debt": {
      "get": {
        "operationId": "rbaHouseholdDebt",
        "summary": "RBA Household Debt to Income",
        "description": "Australian household debt-to-income and debt-to-assets ratios as JSON. Sourced from the RBA E2 selected household ratios table and refreshed quarterly. Track leverage trends without opening the workbook. One bearer token, one call, consistent envelope.",
        "tags": [
          "Macro",
          "RBA"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "RBA Household Debt to Income rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-Q1",
                      "debt_to_income_pct": 184.3,
                      "debt_to_assets_pct": 19.1,
                      "housing_debt_to_income_pct": 142.7
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/rba/household-debt",
                    "source": {
                      "name": "RBA",
                      "url": "https://www.rba.gov.au/statistics/tables/",
                      "attribution": "(c) RBA, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/cost-of-living": {
      "get": {
        "operationId": "absCpiInflation",
        "summary": "ABS Consumer Price Index",
        "description": "Australian Consumer Price Index as JSON, broken down by the eleven CPI expenditure groups. Returns headline CPI, trimmed mean, and which categories are pushing inflation up or down. Sourced from ABS 6401.0 and refreshed each quarter. Replaces parsing the quarterly CPI release table by hand.",
        "tags": [
          "Macro",
          "ABS"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Consumer Price Index rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": {
                    "headline_cpi_yoy_pct": 3.6,
                    "trimmed_mean_yoy_pct": 4,
                    "period": "2025-Q1",
                    "groups": [
                      {
                        "name": "Housing",
                        "yoy_pct": 4.9
                      },
                      {
                        "name": "Food and non-alcoholic beverages",
                        "yoy_pct": 3.8
                      }
                    ]
                  },
                  "meta": {
                    "endpoint": "/v1/cost-of-living",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/economy/price-indexes-and-inflation/consumer-price-index-australia",
                      "attribution": "(c) Commonwealth of Australia (ABS), CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/LABOUR_FORCE": {
      "get": {
        "operationId": "absUnemploymentRate",
        "summary": "ABS Unemployment Rate",
        "description": "Monthly Australian unemployment rate, participation rate, and employment-to-population ratio as JSON. Seasonally adjusted and trend series, national and by state. Sourced from ABS 6202.0 Labour Force and refreshed each release. Headline unemployment without scraping the ABS release page.",
        "tags": [
          "Labour",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "AUS"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Unemployment Rate rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-04",
                      "region": "AUS",
                      "unemployment_rate_pct": 4.1,
                      "participation_rate_pct": 66.7,
                      "employment_pop_ratio_pct": 64
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/LABOUR_FORCE",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/labour/employment-and-unemployment/labour-force-australia",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/WPI": {
      "get": {
        "operationId": "absWagePriceIndex",
        "summary": "ABS Wage Price Index",
        "description": "Quarterly Australian Wage Price Index as JSON. Year-on-year wage growth by industry and sector, national and by state. Sourced from ABS 6345.0 and refreshed each quarter. Pair with CPI to compute real wages without touching SDMX or the WPI workbook.",
        "tags": [
          "Labour",
          "ABS"
        ],
        "parameters": [
          {
            "name": "sector",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Private"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "8"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Wage Price Index rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-Q1",
                      "sector": "Private",
                      "industry": "Total",
                      "wpi_yoy_pct": 3.6
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/WPI",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/economy/price-indexes-and-inflation/wage-price-index-australia",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/GDP": {
      "get": {
        "operationId": "absGdpNationalAccounts",
        "summary": "ABS GDP and National Accounts",
        "description": "Australian Gross Domestic Product and national accounts headlines as JSON. Quarterly real GDP, GDP per capita, and the expenditure-side components. Sourced from ABS 5206.0 and refreshed each release. Headline growth without parsing the National Accounts release table.",
        "tags": [
          "Macro",
          "ABS"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS GDP and National Accounts rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-Q1",
                      "real_gdp_qoq_pct": 0.4,
                      "real_gdp_yoy_pct": 1.6,
                      "gdp_per_capita_qoq_pct": -0.1
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/GDP",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/economy/national-accounts/australian-national-accounts-national-income-expenditure-and-product",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/RETAIL": {
      "get": {
        "operationId": "absRetailTrade",
        "summary": "ABS Retail Trade",
        "description": "Monthly Australian retail turnover as JSON, broken out by industry group and state. Seasonally adjusted and trend series. Sourced from ABS 8501.0 and refreshed each release. Headline consumer-spending indicator without parsing the release tables.",
        "tags": [
          "Macro",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "AUS"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Retail Trade rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-04",
                      "region": "AUS",
                      "industry": "Total",
                      "turnover_aud_m": 36780,
                      "mom_pct": 0.2
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/RETAIL",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/industry/retail-and-wholesale-trade/retail-trade-australia",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/LENDING": {
      "get": {
        "operationId": "absLendingIndicators",
        "summary": "ABS Lending Indicators",
        "description": "Monthly new loan commitments to households and businesses as JSON. Owner-occupier, investor, first home buyer, and business segments. Sourced from ABS 5601.0 Lending Indicators. Track mortgage demand and credit flow without scraping the release.",
        "tags": [
          "Macro",
          "ABS"
        ],
        "parameters": [
          {
            "name": "segment",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "owner_occupier"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Lending Indicators rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-04",
                      "segment": "owner_occupier",
                      "new_commitments_aud_m": 18120,
                      "mom_pct": 1.4
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/LENDING",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/economy/finance/lending-indicators",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/POPULATION": {
      "get": {
        "operationId": "absPopulation",
        "summary": "ABS National and State Population",
        "description": "Quarterly Australian population estimates by state and territory as JSON. Estimated Resident Population plus annual growth rate. Sourced from ABS 3101.0 and refreshed each release. Headline population numbers without parsing the ABS release tables.",
        "tags": [
          "Macro",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "AUS"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS National and State Population rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2024-Q4",
                      "region": "AUS",
                      "erp": 27122000,
                      "yoy_growth_pct": 2
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/POPULATION",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/people/population/national-state-and-territory-population",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/NOM": {
      "get": {
        "operationId": "absNetOverseasMigration",
        "summary": "ABS Net Overseas Migration",
        "description": "Quarterly Net Overseas Migration as JSON. Arrivals, departures and net flow by state and territory. Sourced from ABS 3412.0 and refreshed each release. The migration headline that drives housing and labour-supply commentary, without the SDMX query syntax.",
        "tags": [
          "Macro",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NSW"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Net Overseas Migration rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2024-Q4",
                      "region": "NSW",
                      "arrivals": 102400,
                      "departures": 41200,
                      "net": 61200
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/NOM",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/people/population/overseas-migration",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/trade-balance": {
      "get": {
        "operationId": "absTradeBalance",
        "summary": "ABS International Trade Balance",
        "description": "Monthly Australian international trade balance as JSON. Exports, imports, and the trade balance with top commodity categories. Sourced from ABS 5368.0 and refreshed each release. The headline trade number without scraping the release tables.",
        "tags": [
          "Trade",
          "ABS"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS International Trade Balance rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": {
                    "period": "2025-04",
                    "exports_aud_m": 44320,
                    "imports_aud_m": 37810,
                    "balance_aud_m": 6510,
                    "top_exports": [
                      {
                        "name": "Iron ore",
                        "value_aud_m": 11200
                      }
                    ]
                  },
                  "meta": {
                    "endpoint": "/v1/trade-balance",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/economy/international-trade/international-trade-goods",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/BUILDING_APPROVALS": {
      "get": {
        "operationId": "absBuildingApprovals",
        "summary": "ABS Building Approvals",
        "description": "Monthly Australian dwelling approvals as JSON, broken out by state and capital city and split by building type. Sourced from ABS 8731.0 and refreshed within hours of release. Filter by region, building type, or date range. The same Building Approvals headline that drives housing supply commentary, without the SDMX query syntax.",
        "tags": [
          "Housing",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NSW"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Building Approvals rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-04",
                      "region": "NSW",
                      "building_type": "Houses",
                      "approvals": 2845
                    },
                    {
                      "period": "2025-04",
                      "region": "NSW",
                      "building_type": "Units",
                      "approvals": 1932
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/BUILDING_APPROVALS",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/industry/building-and-construction/building-approvals-australia",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/BA_LGA2024": {
      "get": {
        "operationId": "absLgaBuildingApprovals",
        "summary": "ABS Council-Level Building Approvals",
        "description": "Monthly dwelling approvals at the Local Government Area (LGA) level as JSON. Coverage across roughly 570 Australian councils, by building type. Sourced from ABS 8731.0 with the LGA 2024 boundary set. Filter by council to spot local supply trends without parsing the ABS data cube.",
        "tags": [
          "Housing",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "albury"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Council-Level Building Approvals rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-04",
                      "lga": "Albury (C)",
                      "building_type": "Houses",
                      "approvals": 24
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/BA_LGA2024",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/industry/building-and-construction/building-approvals-australia",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/BUILDING_ACTIVITY": {
      "get": {
        "operationId": "absBuildingActivity",
        "summary": "ABS Building Activity (Completions)",
        "description": "Quarterly dwelling completions as JSON, by state and building type. The supply-side counterpart to building approvals. Sourced from ABS 8752.0 and refreshed each release. Pair with approvals to compute follow-through ratios without parsing the data cube.",
        "tags": [
          "Housing",
          "ABS"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NSW"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "8"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Building Activity (Completions) rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2024-Q4",
                      "region": "NSW",
                      "building_type": "Houses",
                      "completions": 6020
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/BUILDING_ACTIVITY",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/industry/building-and-construction/building-activity-australia",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/abs/RPPI": {
      "get": {
        "operationId": "absResidentialPropertyPrices",
        "summary": "ABS Residential Property Prices",
        "description": "Quarterly Residential Property Price Index (RPPI) as JSON, for the eight capital cities and weighted average. Year-on-year and quarter-on-quarter changes. Sourced from ABS 6432.0. The headline house-price growth without parsing the release.",
        "tags": [
          "Housing",
          "ABS"
        ],
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Sydney"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "8"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ABS Residential Property Prices rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "period": "2025-Q1",
                      "city": "Sydney",
                      "index": 218.4,
                      "qoq_pct": 0.8,
                      "yoy_pct": 6.2
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/abs/RPPI",
                    "source": {
                      "name": "ABS",
                      "url": "https://www.abs.gov.au/statistics/economy/price-indexes-and-inflation/residential-property-price-indexes-eight-capital-cities",
                      "attribution": "(c) ABS, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/austender/contracts": {
      "get": {
        "operationId": "austenderContracts",
        "summary": "AusTender Awarded Government Contracts",
        "description": "Stream awarded Australian Government contracts as JSON. Each row includes agency, supplier, contract value, start and end dates, and category. Sourced from AusTender notices and refreshed daily. Filter by agency, supplier ABN, value range, or date. Cleaner than the AusTender CSV export and indexed for fast queries.",
        "tags": [
          "Trade",
          "AusTender"
        ],
        "parameters": [
          {
            "name": "agency",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Department of Defence"
          },
          {
            "name": "min_value",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1000000"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "10"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "AusTender Awarded Government Contracts rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "contract_id": "CN1234567",
                      "agency": "Department of Defence",
                      "supplier_name": "Example Pty Ltd",
                      "supplier_abn": "12345678901",
                      "value_aud": 2450000,
                      "start_date": "2025-04-01",
                      "end_date": "2026-03-31",
                      "category": "Professional services"
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/austender/contracts",
                    "source": {
                      "name": "AusTender",
                      "url": "https://www.tenders.gov.au/",
                      "attribution": "Commonwealth of Australia, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/austender/suppliers": {
      "get": {
        "operationId": "austenderSuppliers",
        "summary": "AusTender Government Supplier Profiles",
        "description": "Aggregated AusTender supplier profiles as JSON. Total contract value, contract count, top agencies, and category mix per supplier ABN. Built from AusTender contract notices and refreshed daily. Skip the CSV exports and query supplier history directly.",
        "tags": [
          "Trade",
          "AusTender"
        ],
        "parameters": [
          {
            "name": "abn",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12345678901"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "AusTender Government Supplier Profiles rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": {
                    "supplier_abn": "12345678901",
                    "supplier_name": "Example Pty Ltd",
                    "contracts_count": 84,
                    "total_value_aud": 124500000,
                    "top_agencies": [
                      "Department of Defence",
                      "Department of Home Affairs"
                    ]
                  },
                  "meta": {
                    "endpoint": "/v1/data/austender/suppliers",
                    "source": {
                      "name": "AusTender",
                      "url": "https://www.tenders.gov.au/",
                      "attribution": "Commonwealth of Australia, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/ato/corporate-tax": {
      "get": {
        "operationId": "atoCorporateTaxTransparency",
        "summary": "ATO Corporate Tax Transparency",
        "description": "ATO Corporate Tax Transparency report as JSON. Total income, taxable income, and tax payable for large Australian entities. Sourced from the annual ATO release. Skip the spreadsheet and query corporate tax disclosures by ABN or name.",
        "tags": [
          "Regulators",
          "ATO"
        ],
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2023"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ATO Corporate Tax Transparency rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "year": 2023,
                      "name": "Example Holdings Ltd",
                      "abn": "12345678901",
                      "total_income_aud": 8420000000,
                      "taxable_income_aud": 612000000,
                      "tax_payable_aud": 183600000
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/ato/corporate-tax",
                    "source": {
                      "name": "ATO",
                      "url": "https://www.ato.gov.au/business/large-business/in-detail/tax-transparency/",
                      "attribution": "(c) ATO, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/acnc/charities": {
      "get": {
        "operationId": "acncCharityRegister",
        "summary": "ACNC Charity Register",
        "description": "The ACNC charity register as JSON. Charity name, ABN, status, size, jurisdictions, and reported revenue. Sourced from the official ACNC register and refreshed weekly. Verify registered charities or build donation tooling without scraping the ACNC site.",
        "tags": [
          "Social",
          "ACNC"
        ],
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "VIC"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "10"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "ACNC Charity Register rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "name": "Example Foundation",
                      "abn": "12345678901",
                      "status": "Registered",
                      "size": "Large",
                      "state": "VIC",
                      "revenue_aud": 12450000
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/acnc/charities",
                    "source": {
                      "name": "ACNC",
                      "url": "https://www.acnc.gov.au/charity",
                      "attribution": "(c) Commonwealth of Australia (ACNC), CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/wgea/pay-gap": {
      "get": {
        "operationId": "wgeaGenderPayGap",
        "summary": "WGEA Employer Gender Pay Gap",
        "description": "WGEA employer-level gender pay gap as JSON. Median and average base salary gaps, total remuneration gap, and industry comparators. Sourced from WGEA's published employer dataset. Skip the spreadsheet and query the official pay-gap figures by ABN or industry.",
        "tags": [
          "Social",
          "WGEA"
        ],
        "parameters": [
          {
            "name": "industry",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Financial and Insurance Services"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "WGEA Employer Gender Pay Gap rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "employer": "Example Corp",
                      "abn": "12345678901",
                      "industry": "Financial and Insurance Services",
                      "median_base_pay_gap_pct": 14.3,
                      "total_remuneration_gap_pct": 21.7
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/wgea/pay-gap",
                    "source": {
                      "name": "WGEA",
                      "url": "https://www.wgea.gov.au/",
                      "attribution": "(c) WGEA, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/energy-snapshot": {
      "get": {
        "operationId": "aemoNemSpotPrices",
        "summary": "AEMO NEM Spot Prices",
        "description": "Live National Electricity Market spot prices as JSON, by region: NSW1, VIC1, QLD1, SA1, TAS1. Latest dispatch price plus rolling averages. Sourced from AEMO live data. Skip the AEMO CSV dump and pull NEM prices directly into dashboards, alerts, or optimisation logic.",
        "tags": [
          "Energy",
          "AEMO"
        ],
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "AEMO NEM Spot Prices rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "region": "NSW1",
                      "price_aud_mwh": 92.4,
                      "dispatch_time": "2025-05-20T14:35:00+10:00"
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/energy-snapshot",
                    "source": {
                      "name": "AEMO",
                      "url": "https://aemo.com.au/",
                      "attribution": "(c) AEMO, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/nem-dispatch-5min": {
      "get": {
        "operationId": "aemoNemDispatch",
        "summary": "AEMO NEM 5-Minute Dispatch",
        "description": "5-minute NEM dispatch prices as JSON across all regions. Time-series ready, suited to backtests and trading models. Sourced from AEMO's dispatch feed. Get raw 5-minute history without parsing the public CSV archive.",
        "tags": [
          "Energy",
          "AEMO"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NSW1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "12"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "AEMO NEM 5-Minute Dispatch rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "region": "NSW1",
                      "interval": "2025-05-20T14:35:00+10:00",
                      "price_aud_mwh": 92.4,
                      "demand_mw": 8420
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/nem-dispatch-5min",
                    "source": {
                      "name": "AEMO",
                      "url": "https://aemo.com.au/",
                      "attribution": "(c) AEMO, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/weather/observations": {
      "get": {
        "operationId": "bomWeatherObservations",
        "summary": "BOM Weather Observations",
        "description": "Current Australian weather observations as JSON by station. Temperature, humidity, wind, rainfall, and pressure. Sourced from the BOM observations feed and refreshed every 10 minutes. Skip the AXF and XML feeds and pull station-level conditions with a bearer token.",
        "tags": [
          "Social",
          "BOM"
        ],
        "parameters": [
          {
            "name": "station",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "066062"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "BOM Weather Observations rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": {
                    "station": "066062",
                    "name": "Sydney (Observatory Hill)",
                    "temp_c": 18.2,
                    "humidity_pct": 64,
                    "wind_kmh": 14,
                    "rainfall_mm": 0,
                    "pressure_hpa": 1018.3,
                    "observed_at": "2025-05-20T14:30:00+10:00"
                  },
                  "meta": {
                    "endpoint": "/v1/weather/observations",
                    "source": {
                      "name": "BOM",
                      "url": "http://www.bom.gov.au/",
                      "attribution": "(c) Commonwealth of Australia (BOM)"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/data/aihw/hospitals": {
      "get": {
        "operationId": "aihwHospitalStatistics",
        "summary": "AIHW Hospital Statistics",
        "description": "Australian public and private hospital statistics as JSON. Separations, average length of stay, and ED presentations by state and hospital sector. Sourced from AIHW MyHospitals and refreshed annually. Skip the AIHW workbook and query hospital activity directly.",
        "tags": [
          "Social",
          "AIHW"
        ],
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NSW"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "AIHW Hospital Statistics rows",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "meta": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "year": 2024,
                      "state": "NSW",
                      "sector": "Public",
                      "separations": 2120000,
                      "avg_los_days": 5.4,
                      "ed_presentations": 3320000
                    }
                  ],
                  "meta": {
                    "endpoint": "/v1/data/aihw/hospitals",
                    "source": {
                      "name": "AIHW",
                      "url": "https://www.aihw.gov.au/reports-data/myhospitals",
                      "attribution": "(c) AIHW, CC-BY 4.0"
                    },
                    "retrieved_at": "<ISO timestamp>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/search-datasets": {
      "get": {
        "operationId": "searchDatasets",
        "summary": "Plain-English search across all datasets",
        "description": "Search 30+ Australian government datasets by keyword. Returns matching datasets with endpoint paths, agency, and update frequency.",
        "tags": [
          "Discovery"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "interest rates"
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Matching datasets"
          }
        }
      }
    },
    "/v1/status": {
      "get": {
        "operationId": "getStatus",
        "summary": "Per-source health and 30-day uptime",
        "tags": [
          "Meta"
        ],
        "responses": {
          "200": {
            "description": "Source health"
          }
        }
      }
    },
    "/v1/whoami": {
      "get": {
        "operationId": "whoAmI",
        "summary": "Current tier and usage for the bearer token",
        "tags": [
          "Meta"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Account info"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Full documentation",
    "url": "https://ausdata.io/docs"
  }
}