{
  "openapi": "3.1.0",
  "info": {
    "title": "MyTrustedTraders public tools API",
    "version": "1.0.0",
    "description": "Public JSON endpoints over independent trust evidence for contractors. No auth; every figure names its public source. For the fuller toolset use the MCP server at https://mcp.mytrustedtraders.com."
  },
  "servers": [
    {
      "url": "https://us.mytrustedtraders.com"
    }
  ],
  "paths": {
    "/api/tools/council-experience": {
      "get": {
        "operationId": "councilExperience",
        "summary": "Architects with a public planning track record, by council and work type.",
        "parameters": [
          {
            "name": "market",
            "in": "query",
            "required": false,
            "description": "ISO-ish market code (uk, us, au, ca, nz, ie, za) — overrides the host market.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Architects with a public planning track record, by council and work type."
          }
        }
      }
    },
    "/api/tools/certifications": {
      "get": {
        "operationId": "listCertifications",
        "summary": "Trade certifications and licences for this market; pass ?scheme=<slug> for one scheme with holder aggregates and how-to-verify, or ?reference=<number> to check a licence number against held records.",
        "parameters": [
          {
            "name": "market",
            "in": "query",
            "required": false,
            "description": "ISO-ish market code (uk, us, au, ca, nz, ie, za) — overrides the host market.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scheme",
            "in": "query",
            "required": false,
            "description": "A certification scheme slug (e.g. gas-safe-register). Returns that one scheme with aggregates and visible holders.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Max visible holders to return for a single scheme.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "query",
            "required": false,
            "description": "A licence or registration number to check against held records (as-of-dated evidence plus the official register link; absence never means unregistered).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Trade certifications and licences for this market; pass ?scheme=<slug> for one scheme with holder aggregates and how-to-verify, or ?reference=<number> to check a licence number against held records."
          }
        }
      }
    },
    "/api/tools/planning-finder": {
      "get": {
        "operationId": "planningFinder",
        "summary": "Planning applications and the architects behind them near a postcode.",
        "parameters": [
          {
            "name": "market",
            "in": "query",
            "required": false,
            "description": "ISO-ish market code (uk, us, au, ca, nz, ie, za) — overrides the host market.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Planning applications and the architects behind them near a postcode."
          }
        }
      }
    },
    "/api/tools/planning-approval-rate": {
      "get": {
        "operationId": "planningApprovalRate",
        "summary": "An architect or firm's council planning approval rate.",
        "parameters": [
          {
            "name": "market",
            "in": "query",
            "required": false,
            "description": "ISO-ish market code (uk, us, au, ca, nz, ie, za) — overrides the host market.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "An architect or firm's council planning approval rate."
          }
        }
      }
    },
    "/api/tools/planning-odds": {
      "get": {
        "operationId": "planningOdds",
        "summary": "Approval odds and typical decision time for a work type at a council; pass ?council=<name>&workType=<name>.",
        "parameters": [
          {
            "name": "market",
            "in": "query",
            "required": false,
            "description": "ISO-ish market code (uk, us, au, ca, nz, ie, za) — overrides the host market.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "council",
            "in": "query",
            "required": false,
            "description": "Council / local planning authority name (e.g. Barnet).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workType",
            "in": "query",
            "required": false,
            "description": "Type of work (e.g. rear extension, loft conversion, dropped kerb).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Approval odds and typical decision time for a work type at a council; pass ?council=<name>&workType=<name>."
          }
        }
      }
    }
  }
}