{"openapi":"3.1.0","info":{"title":"UK Taxi PHV Regulatory Decision API","version":"1.0.1","description":"HTTP compatibility surface for the same deterministic, evidence-linked licensing decision engine exposed over MCP.","x-guidance":"Use the free MCP discovery/status tools before purchase when authority support or evidence freshness matters. Paid HTTP routes use the same deterministic engine and per-rule freshness guards as the MCP tools. Runtime 402 payment requirements are authoritative.","x-uk-taxi-phv":{"mcp":"https://uk-taxi-phv-mcp-production.up.railway.app/mcp","network":"eip155:8453","paymentProtocol":"x402-v2","currency":"USDC","safety":"Preflight information only; not licensing-authority approval or legal advice."}},"servers":[{"url":"https://uk-taxi-phv-mcp-production.up.railway.app"}],"paths":{"/api/v1/preflight":{"post":{"operationId":"uk-taxi-phv-licence-preflight","summary":"UK taxi/private-hire licensing preflight","description":"One-authority deterministic England taxi-private-hire licensing preflight for a supported authority. Use for applicant, driver, vehicle, or operator blocker checks, missing-input identification, and the next evidence-gated action before submission or onboarding. This tool does not compare authorities. Pay when you need missing-input and next-action guidance before submission or onboarding. Payment verification precedes execution; current official evidence is still required.","tags":["taxi","private-hire","licensing","regulatory"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"One-authority deterministic England taxi-private-hire licensing preflight for a supported authority. Use for applicant, driver, vehicle, or operator blocker checks, missing-input identification, and the next evidence-gated action before submission or onboarding. This tool does not compare authorities.","properties":{"authority":{"type":"string","description":"Exactly one supported England taxi/PHV licensing authority for this one-authority preflight."},"age":{"type":"number","description":"Applicant age in years, when relevant to the authority rules."},"driving_licence_years":{"type":"number","description":"Years the applicant has held the relevant driving licence, when relevant to the authority rules."},"has_pass_plus_certificate":{"type":"boolean","description":"Whether the applicant has the Pass Plus certificate, when relevant to the authority rules."}},"required":["authority"],"additionalProperties":true},"example":{"authority":"City of Bradford Metropolitan District Council","age":30,"driving_licence_years":4,"has_pass_plus_certificate":true}}}},"responses":{"200":{"description":"Evidence-linked deterministic preflight result."},"402":{"description":"Payment Required. Inspect the runtime x402 v2 PAYMENT-REQUIRED header for authoritative chain, asset, amount and payment requirements."},"422":{"description":"Invalid request."}}}},"/api/v1/compare":{"post":{"operationId":"uk-taxi-phv-licensing-compare","summary":"Compare taxi/private-hire licensing requirements","description":"Cross-authority deterministic England taxi-private-hire licensing trade-off comparison for two or more supported authorities. Use for licensing trade-offs before choosing where to license; the same applicant/activity facts are assessed per candidate and official-evidence freshness is gated independently. This tool is not a one-authority preflight. Pay before choosing where to license. Payment verification precedes execution; stale or unsupported authorities remain confirmation-required.","tags":["taxi","private-hire","licensing","comparison"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Cross-authority deterministic England taxi-private-hire licensing trade-off comparison for two or more supported authorities. Use for licensing trade-offs before choosing where to license; the same applicant/activity facts are assessed per candidate and official-evidence freshness is gated independently. This tool is not a one-authority preflight.","properties":{"authorities":{"type":"array","items":{"type":"string"},"minItems":2,"description":"Two or more supported licensing authorities to compare before choosing where to license; this is not a single-authority preflight."},"applicant":{"type":"object","description":"The same applicant, driver, vehicle, or operator facts to assess consistently for each candidate authority.","additionalProperties":true}},"required":["authorities","applicant"],"additionalProperties":true},"example":{"authorities":["City of Bradford Metropolitan District Council","Cambridge City Council"],"applicant":{"age":30,"driving_licence_years":4,"has_pass_plus_certificate":true}}}}},"responses":{"200":{"description":"Evidence-linked cross-authority comparison."},"402":{"description":"Payment Required. Inspect the runtime x402 v2 PAYMENT-REQUIRED header for authoritative chain, asset, amount and payment requirements."},"422":{"description":"Invalid request."}}}}}}