{
  "info": {
    "_postman_id": "fbf49a3a-83e6-456d-8a9e-a1656ccf53f8",
    "name": "Beacon Ingest API",
    "description": "Contract for currently implemented Beacon ingest endpoints and SMART Health Card/SMART Health Link ingest endpoints.\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{access_token}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://prod.parkerapex.com",
      "type": "string"
    },
    {
      "key": "access_token",
      "value": "REPLACE_WITH_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Beacon Ingest",
      "item": [
        {
          "name": "Request a direct upload URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/beacon/api/uploads/signed-url",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "beacon",
                "api",
                "uploads",
                "signed-url"
              ]
            },
            "description": "Requires Beacon auth and `patient/*.write` permission. Generates a short-lived GCS PUT URL for direct browser upload.\n",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Finalize a direct upload",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/beacon/api/uploads/finalize",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "beacon",
                "api",
                "uploads",
                "finalize"
              ]
            },
            "description": "Creates Beacon document metadata and enqueues the processing pipeline. Requires Beacon auth and `patient/*.write` permission.\n",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "SMART Health Cards",
      "item": [
        {
          "name": "SMART Health Card ingest verification (Implemented)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/smart-health-cards/ingest",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "smart-health-cards",
                "ingest"
              ]
            },
            "description": "Verifies SMART Health Card/SMART Health Link payloads, checks temporal constraints, records each verification decision, and returns a deterministic `verification_id` for readback. In production, set `SMART_HEALTH_CARD_VERIFY_MODE=strict` and enforce issuer allow-listing.\n",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "SMART Health Card verification status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/smart-health-cards/verification",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "smart-health-cards",
                "verification"
              ]
            },
            "description": "Retrieve deterministic verification status and evidence for a prior ingest request.\n"
          }
        }
      ]
    }
  ]
}