GeezerKeeper Reference data API

openapi: 3.2.0
info:
  title: GeezerKeeper Referral Exit-Route Reference Reference data…
  version: 1.3.0
  description: Public, read-only reference data for agents helping U.S. families organize unwanted contact after a senior-care referral search and senior-living operators check source-published duplicate-referral deadlines. These endpoints never accept personal information and never submit requests.
  termsOfService: https://geezerkeeper.com/terms.html
  contact:
    name: GeezerKeeper corrections
    email: corrections@geezerkeeper.com
    url: https://geezerkeeper.com/routes/
  license:
    name: CC BY 4.0
    identifier: CC-BY-4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://geezerkeeper.com
  description: Production
security: []
tags:
- name: Reference data
  description: Maintained, privacy-safe facts and unfilled templates.
paths:
  /routes.json:
    get:
      operationId: getReferralExitRoutes
      summary: Get verified senior-care referral exit routes
      description: Returns maintained policy, preference-center, privacy-contact, and provider-follow-up facts. Verify the linked primary source before use.
      tags:
      - Reference data
      responses:
        '200':
          description: Current route registry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteRegistry'
        '404':
          description: Reference file not found
  /referral-deadlines.json:
    get:
      operationId: getDuplicateReferralDeadlines
      summary: Get source-maintained senior-living duplicate-referral deadline facts
      description: Returns reviewed public deadline, reporting-route, source, and uncertainty fields. The actual lead alert and signed agreement control; this endpoint accepts no lead data and submits no duplicate report.
      tags:
      - Reference data
      responses:
        '200':
          description: Current duplicate-referral deadline registry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferralDeadlineRegistry'
        '404':
          description: Reference file not found
  /reported-numbers.csv:
    get:
      operationId: getReportedNumbersCsv
      summary: Download the reported-number evidence as CSV
      tags:
      - Reference data
      responses:
        '200':
          description: Spreadsheet-ready evidence export with uncertainty fields
          content:
            text/csv:
              schema:
                type: string
  /feed.json:
    get:
      operationId: getReportedNumberJsonFeed
      summary: Subscribe to reported-number evidence through JSON Feed
      tags:
      - Reference data
      responses:
        '200':
          description: JSON Feed 1.1 representation of the evidence registry
          content:
            application/feed+json:
              schema:
                type: object
                additionalProperties: true
  /feed.xml:
    get:
      operationId: getReportedNumberAtomFeed
      summary: Subscribe to reported-number evidence through Atom
      tags:
      - Reference data
      responses:
        '200':
          description: Atom 1.0 representation of the evidence registry
          content:
            application/atom+xml:
              schema:
                type: string
  /request-templates.json:
    get:
      operationId: getPrivacySafeRequestTemplates
      summary: Get unfilled stop-contact request templates
      description: Returns templates with bracketed placeholders. Replace placeholders locally; never send completed text or personal information to GeezerKeeper.
      tags:
      - Reference data
      responses:
        '200':
          description: Unfilled templates and data boundary
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestTemplateRegistry'
        '404':
          description: Reference file not found
  /offer.json:
    get:
      operationId: getGeezerKeeperOfferFit
      summary: Get free, consumer, and professional product-fit rules
      description: Returns current prices, purchase URLs, fit signals, delivery details, and privacy boundaries.
      tags:
      - Reference data
      responses:
        '200':
          description: Current GeezerKeeper product-fit data
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '404':
          description: Reference file not found
components:
  schemas:
    RequestTemplateRegistry:
      type: object
      required:
      - schemaVersion
      - templateOnly
      - dataBoundary
      - templates
      - disclaimer
      properties:
        schemaVersion:
          type: string
        templateOnly:
          type: boolean
          const: true
        dataBoundary:
          type: object
          required:
          - acceptsPersonalInformation
          - submitsRequests
          - instruction
          properties:
            acceptsPersonalInformation:
              type: boolean
              const: false
            submitsRequests:
              type: boolean
              const: false
            instruction:
              type: string
        templates:
          type: object
          additionalProperties: true
        disclaimer:
          type: string
      additionalProperties: true
    RouteRegistry:
      type: object
      required:
      - schemaVersion
      - reviewedAt
      - routes
      - disclaimer
      properties:
        schemaVersion:
          type: string
        reviewedAt:
          type: string
          format: date
        disclaimer:
          type: string
        routes:
          type: array
          items:
            $ref: '#/components/schemas/ExitRoute'
      additionalProperties: true
    ExitRoute:
      type: object
      required:
      - id
      - name
      - privacyPolicyUrl
      - guideUrl
      - reviewedAt
      properties:
        id:
          type: string
          enum:
          - apfm
          - caring
          - seniorly
          - seniorhousingnet
        name:
          type: string
        domains:
          type: array
          items:
            type: string
        privacyPolicyUrl:
          type: string
          format: uri
        controlUrl:
          type: string
          format: uri
        privacyEmail:
          type: string
          format: email
        privacyPhone:
          type: string
        requestSubject:
          type: string
        textOptOut:
          type: string
        providerFollowup:
          type: string
        guideUrl:
          type: string
          format: uri
        preSubmitGuideUrl:
          type: string
          format: uri
        reviewedAt:
          type: string
          format: date
      additionalProperties: true
    ReferralDeadlineRegistry:
      type: object
      required:
      - schemaVersion
      - reviewedAt
      - dataBoundary
      - policies
      - disclaimer
      properties:
        schemaVersion:
          type: string
        reviewedAt:
          type: string
          format: date
        dataBoundary:
          type: object
          required:
          - acceptsPersonalInformation
          - submitsDuplicateReports
          properties:
            acceptsPersonalInformation:
              type: boolean
              const: false
            submitsDuplicateReports:
              type: boolean
              const: false
        policies:
          type: array
          items:
            type: object
            additionalProperties: true
        disclaimer:
          type: string
      additionalProperties: false
x-mcp-server:
  transport: streamable-http
  url: https://geezerkeeper.com/mcp
  authentication: none
  publicmcpVersion: '0.3'
  dataBoundary: Read-only; business identity and coverage tools accept no input, and other tools accept enumerated route, deadline, service, and workflow choices only, never personal information.