Geo-Parity Healthcare.json API

openapi: 3.2.0
info:
  title: Geo-Parity Healthcare.json API
  version: 1.0.0
  description: 'Free, key-less JSON APIs behind geo-parity.com: purchasing power parity, fair global salaries, Schengen 90/180 compliance, cross-timezone meetings, contractor economics, freelance rates, tax-residency day counts, country comparison, cloud region latency, and a digital-nomad visa directory. All GET responses are cacheable; errors return { ok:false, code, message, example }. No key is required: anonymous callers get 1,500 requests/month per IP plus a 30/minute burst cap. An optional API key (Authorization: Bearer gp_live_..., created at /account) only raises those ceilings — responses are identical either way, and a key is metered per account rather than per key. Every response carries X-RateLimit-Limit / -Remaining / -Reset (the minute window) and X-Quota-Limit / -Remaining / -Reset (the calendar month, resetting on the 1st UTC); exceeding either returns 429 with Retry-After and code RATE_LIMITED (slow down) or QUOTA_EXCEEDED (allowance spent — retrying will not help). Figures are informational estimates, not financial/tax/legal advice. Machine discovery: /llms.txt and /.well-known/mcp.json; the same tools are also registered with the browser''s WebMCP ModelContext on every page, executing through /api/mcp.'
  contact:
    url: https://geo-parity.com
servers:
- url: https://geo-parity.com
security:
- {}
- bearerAuth: []
- apiKeyQuery: []
tags:
- name: Healthcare.json
paths:
  /api/healthcare.json:
    get:
      operationId: compareHealthcare
      summary: Healthcare cost and financial exposure by country
      description: 'Out-of-pocket spend per person, out-of-pocket share, total health spend per capita (PPP), government funding share, physicians per 1,000 and dentists per 10,000, across 182 countries. Measured from World Bank and WHO Global Health Observatory series, never derived from a price index: scaling healthcare by a country''s general price level overstates costs abroad by 1.2x-5.4x. Dental is reported as access (dentist density), not price. National averages; not medical, insurance or financial advice.'
      parameters:
      - name: sort
        in: query
        required: false
        description: Metric to rank by. Default outOfPocket.
        schema:
          type: string
          enum:
          - outOfPocket
          - spend
          - exposure
          - doctors
          - dentists
          default: outOfPocket
      - name: country
        in: query
        required: false
        description: ISO 3166-1 alpha-2 code; echoes that country's row and rank.
        schema:
          type: string
      - name: maxOutOfPocketPct
        in: query
        required: false
        description: Keep only countries at or below this out-of-pocket share (%).
        schema:
          type: number
          minimum: 0
      - name: minPhysiciansPer1000
        in: query
        required: false
        description: Keep only countries with at least this many physicians per 1,000.
        schema:
          type: number
          minimum: 0
      responses:
        '200':
          description: Ranked countries with per-metric reference years and an attribution block.
        '400':
          description: Invalid parameter (bad sort, or a negative filter).
        '422':
          description: Unknown country code.
      tags:
      - Healthcare.json
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Optional Geo-Parity API key (gp_live_...), created at /account. Raises the monthly quota and per-minute burst; never changes a response. Metered per account, so extra keys do not add allowance.
    apiKeyQuery:
      type: apiKey
      in: query
      name: key
      description: The same key, for clients that cannot set headers.
externalDocs:
  description: 'Developer guide: quota ladder, error codes, API keys and MCP setup'
  url: https://geo-parity.com/developers/