openapi: 3.2.0
info:
  title: PaidHandshake Exchange Sample API
  version: 2.9.0
  description: Broad lawful paid public-web research and commercial-intelligence routing, verified data feeds, delegated machine payments and recurring watches for autonomous agents.
servers:
- url: https://paidhandshake.com
tags:
- name: Sample
paths:
  /api/v1/sample:
    get:
      operationId: getFreeDataSample
      summary: Get one quality-gated sample from a premium data feed
      parameters:
      - name: feed
        in: query
        required: true
        schema:
          type: string
          enum:
          - rfp-procurement
          - business-buyer-intent
          - vendor-product-pricing
          - local-service-availability
          - grants-funding
          - business-expansion-permits
          - jobs-contract-work
      responses:
        '200':
          description: Feed sample or warming/quality-hold status
      tags:
      - Sample
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: One-time-issued phm_ machine API key. Store securely; PaidHandshake stores only a hash.