← Back to writing samples

API Reference

Portfolio sample. Demonstrates RESTful and HL7 FHIR API documentation, OAuth2 authentication flows, payload schemas, endpoint specifications, rate limiting, and webhook ingestion architecture.

Healthcare Data Exchange: REST & HL7 FHIR R4 Integration Guide

API Version: v2.4-fhir • Protocol: HTTPS REST / JSON • Standard: HL7 FHIR Release 4 • Auth: OAuth 2.0 (Bearer Token)

1. Overview & Authentication

The Meridian Health Interoperability API enables external EHR systems, payer platforms, and care management applications to synchronize clinical encounter data and member profiles in real time.

POST /oauth/token HTTP/1.1
Host: api.meridianhealth.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET&scope=patient/*.read encounter/*.write

2. Core Endpoints Reference

GET /api/v2/fhir/r4/Patient/{id}

{
  "resourceType": "Patient",
  "id": "MER-908214",
  "identifier": [{ "system": "http://meridianhealth.com/member-id", "value": "MEDICARE-FL-883920" }],
  "active": true,
  "name": [{ "use": "official", "family": "Severn", "given": ["Justin"] }],
  "gender": "male",
  "birthDate": "1988-12-14"
}