{
  "info": {
    "_postman_id": "19d4f515-ece2-4914-af55-43f7914636c7",
    "name": "APEX Nexus Platform API",
    "description": "OpenAPI contract for **APEX Nexus**, Parker Apex's flagship clinical platform (EHR + integrations).\n\n**Production hosts:** Nexus Flask API at `cms.nexus.parkerapex.com` (Cloud Run `apex-v2`);\nNexus EHR UI at `nexus.parkerapex.com` (Cloud Run `nexus-frontend-prod`); partner gateway at\n`api.parkerapex.com`. Pulse PHR is a separate product at `pulse.parkerapex.com` \u2014 not served from\nthe Nexus API host.\n\nNexus exposes FHIR R4 (96.7% coverage), SMART on FHIR OAuth 2.0, bulk `$export`,\nmobile-optimized REST, semantic federated queries, GPID identity resolution, and clinical modules.\n\n**Related products:** Pulse PHR at `pulse.parkerapex.com` consumes `/mobile/api/*`; partners integrate\nvia OAuth scopes documented in the [developer portal](https://developers.parkerapex.com/guides/first-fhir-read).\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://api.parkerapex.com",
      "type": "string"
    },
    {
      "key": "access_token",
      "value": "REPLACE_WITH_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Platform",
      "item": [
        {
          "name": "Platform health",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/health",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "health"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Readiness probe",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/ready",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "ready"
              ]
            },
            "description": ""
          }
        }
      ]
    },
    {
      "name": "FHIR R4",
      "item": [
        {
          "name": "FHIR R4 CapabilityStatement",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/metadata",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                "metadata"
              ]
            },
            "description": "Describes supported resources, search parameters, and operations."
          }
        },
        {
          "name": "Search Patient resources",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/Patient",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                "Patient"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Create Patient resource",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/Patient",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                "Patient"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Read Patient by id",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/Patient/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                "Patient",
                "{id}"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Search Observation resources",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/Observation",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                "Observation"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Process FHIR transaction Bundle",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Bulk FHIR data export ($export)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/$export",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                "$export"
              ]
            },
            "description": "Initiates asynchronous NDJSON bulk export. Poll `Content-Location` until complete."
          }
        }
      ]
    },
    {
      "name": "SMART",
      "item": [
        {
          "name": "SMART on FHIR discovery",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/R4/.well-known/smart-configuration",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "R4",
                ".well-known",
                "smart-configuration"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "OAuth 2.0 token endpoint",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/oauth/token",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "oauth",
                "token"
              ]
            },
            "description": "Client credentials and authorization code grants for SMART and partner integrations.",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Mobile",
      "item": [
        {
          "name": "Patient mobile dashboard (Pulse PHR)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/mobile/api/patient/dashboard",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "mobile",
                "api",
                "patient",
                "dashboard"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "List patient appointments",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/mobile/api/patient/appointments",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "mobile",
                "api",
                "patient",
                "appointments"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Patient medical records summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/mobile/api/patient/medical-records",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "mobile",
                "api",
                "patient",
                "medical-records"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Update linked patient demographics for Pulse user",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/pulse/profile",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "pulse",
                "profile"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Unified appointments and requests for Pulse patient",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/pulse/appointments",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "pulse",
                "appointments"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Patient-initiated appointment request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/pulse/appointments",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "pulse",
                "appointments"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Secure message threads for Pulse patient",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/pulse/messages",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "pulse",
                "messages"
              ]
            },
            "description": ""
          }
        }
      ]
    },
    {
      "name": "Identity",
      "item": [
        {
          "name": "Resolve or create GPID from demographics",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/identity/resolve",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "identity",
                "resolve"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Semantic",
      "item": [
        {
          "name": "Federated semantic data query",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/semantic/query",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "semantic",
                "query"
              ]
            },
            "description": "POST structured resource blocks; fans out to registered Nexus adapters with purpose-of-use enforcement.",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Discover semantic adapter resource types",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/semantic/schema",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "semantic",
                "schema"
              ]
            },
            "description": ""
          }
        }
      ]
    },
    {
      "name": "Clinical",
      "item": [
        {
          "name": "Validate cohort criteria DSL and return match count",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/cohort/count",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "cohort",
                "count"
              ]
            },
            "description": "Returns `501` with `criteria_valid` until lake-backed matching engine ships (Phase 2).",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "List schedulable clinical providers",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/providers",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "providers"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Create staff-scheduled appointment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/appointments",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "appointments"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Update appointment fields",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/appointments/{appointment_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "appointments",
                "{appointment_id}"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Soft-cancel an appointment",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/appointments/{appointment_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "appointments",
                "{appointment_id}"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "30-day readmission analytics",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/analytics/readmissions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "analytics",
                "readmissions"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Chronic disease prevalence and comorbidity trends",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/analytics/disease-trends",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "analytics",
                "disease-trends"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "HEDIS and CMS Star quality measures",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/analytics/quality",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "analytics",
                "quality"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Cohort size for combined demographic/clinical filters",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/analytics/cohorts",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "analytics",
                "cohorts"
              ]
            },
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Telehealth sessions for provider workspace",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/telehealth/sessions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "telehealth",
                "sessions"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Role distribution and recent admin activity",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/admin/overview",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "admin",
                "overview"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Live ePrescribing integration health",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/integrations/eprescribing/status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "integrations",
                "eprescribing",
                "status"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Prescriber EPCS enrollment status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/eprescribing/enrollment",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "eprescribing",
                "enrollment"
              ]
            },
            "description": ""
          }
        },
        {
          "name": "Production cutover certification checklist",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v2/eprescribing/certification",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v2",
                "eprescribing",
                "certification"
              ]
            },
            "description": ""
          }
        }
      ]
    }
  ]
}