Redix Universal Healthcare Data Converter

Endpoint:

Description:

Convert HL7 v2.x messages to FHIR R4 bundles. Supports ADT, ORU, ORM, SIU, VXU, MDM, DFT, and more.

Request Example:

• cURL
• Python
• JavaScript

curl -X POST https://demo.redix.com/api/v2/convert/hl7-to-fhir \
  -H "Content-Type: application/json" \
  -d '{
    "content": "MSH|^~\\&|SendApp|SendFac|RecApp|RecFac|20240101120000||ADT^A01|123456|P|2.5\rPID|1||12345^^^MRN||DOE^JOHN^A||19800101|M|||123 MAIN ST^^CITY^ST^12345||555-1234|||S||"
  }'

import requests

hl7_message = """MSH|^~\\&|SendApp|SendFac|RecApp|RecFac|20240101120000||ADT^A01|123456|P|2.5
PID|1||12345^^^MRN||DOE^JOHN^A||19800101|M|||123 MAIN ST^^CITY^ST^12345||555-1234|||S||"""

response = requests.post(
    'https://demo.redix.com/api/v2/convert/hl7-to-fhir',
    json={'content': hl7_message}
)

result = response.json()
if result['success']:
    fhir_bundle = result['fhir_bundle']
    print(f"✓ Converted to {len(fhir_bundle['entry'])} FHIR resources")
else:
    print(f"✗ Error: {result['error']}")

const hl7Message = `MSH|^~\\&|SendApp|SendFac|RecApp|RecFac|20240101120000||ADT^A01|123456|P|2.5
PID|1||12345^^^MRN||DOE^JOHN^A||19800101|M|||123 MAIN ST^^CITY^ST^12345||555-1234|||S||`;

fetch('https://demo.redix.com/api/v2/convert/hl7-to-fhir', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ content: hl7Message })
})
.then(res => res.json())
.then(result => {
    if (result.success) {
        console.log('✓ FHIR Bundle:', result.fhir_bundle);
    } else {
        console.error('✗ Error:', result.error);
    }
});

Response Format:

{
  "success": true,
  "message_type": "ADT",
  "description": "Admit/Discharge/Transfer",
  "fhir_bundle": {
    "resourceType": "Bundle",
    "type": "collection",
    "entry": [
      {
        "resource": {
          "resourceType": "Patient",
          "id": "patient-12345",
          "name": [{"family": "DOE", "given": ["JOHN"]}],
          "birthDate": "1980-01-01",
          "gender": "male"
        }
      }
    ]
  },
  "metadata": {
    "patient_id": "12345",
    "patient_name": "JOHN DOE",
    "message_control_id": "123456"
  }
}

Endpoint:

Description:

Convert CDA (Clinical Document Architecture) documents to FHIR R4 bundles. Supports C-CDA, CCD, discharge summaries, progress notes, and more.

Request Example:

• cURL
• Python
• JavaScript

curl -X POST https://demo.redix.com/api/v2/convert/cda-to-fhir \
  -H "Content-Type: application/json" \
  -d '{
    "content": "\n..."
  }'

import requests

# Read CDA XML file
with open('ccd_sample.xml', 'r') as f:
    cda_content = f.read()

response = requests.post(
    'https://demo.redix.com/api/v2/convert/cda-to-fhir',
    json={'content': cda_content}
)

result = response.json()
if result['success']:
    fhir_bundle = result.get('fhir_bundle') or result.get('output')
    print(f"✓ CDA converted successfully")
else:
    print(f"✗ Error: {result['error']}")

// Read CDA XML content
const cdaXml = `

  
`;

fetch('https://demo.redix.com/api/v2/convert/cda-to-fhir', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ content: cdaXml })
})
.then(res => res.json())
.then(result => {
    if (result.success) {
        console.log('✓ FHIR Output:', result.fhir_bundle || result.output);
    } else {
        console.error('✗ Error:', result.error);
    }
});

Response Format:

{
  "success": true,
  "output": {
    "resourceType": "Bundle",
    "type": "collection",
    "entry": [
      {
        "resource": {
          "resourceType": "Composition",
          "type": {"coding": [{"code": "34133-9", "display": "Summarization of Episode Note"}]},
          "subject": {"reference": "Patient/patient-id"}
        }
      },
      {
        "resource": {
          "resourceType": "Patient",
          "name": [{"family": "Smith", "given": ["Jane"]}]
        }
      }
    ]
  }
}

Endpoint:

Description:

Universal conversion endpoint with smart format detection. Handles HIPAA/X12 (837, 835, 270, 271, etc.), EDIFACT/RMap, XML, CSV, fixed-format files, and custom conversions.

Supported Formats:

Request Example (HIPAA 837P):

• cURL
• Python
• JavaScript

curl -X POST https://demo.redix.com/api/v2/convert/smart \
  -H "Content-Type: application/json" \
  -d '{
    "content": "ISA*00*          *00*          *ZZ*SENDER         *ZZ*RECEIVER       *240101*1200*^*00501*000000001*0*P*:~GS*HC*SENDER*RECEIVER*20240101*1200*1*X*005010X222A1~..."
  }'

import requests

# Example: HIPAA 837P Professional Claims
x12_837p = """ISA*00*          *00*          *ZZ*SENDER         *ZZ*RECEIVER       *240101*1200*^*00501*000000001*0*P*:~
GS*HC*SENDER*RECEIVER*20240101*1200*1*X*005010X222A1~
ST*837*0001*005010X222A1~
BHT*0019*00*123456*20240101*1200*CH~
..."""

response = requests.post(
    'https://demo.redix.com/api/v2/convert/smart',
    json={'content': x12_837p}
)

result = response.json()
if result['success']:
    output = result.get('output') or result.get('fhir_bundle')
    print(f"✓ Conversion successful")
    print(f"Output: {output}")
else:
    print(f"✗ Error: {result['error']}")

// Example: CSV to JSON conversion
const csvData = `PatientID,FirstName,LastName,DOB,Gender
12345,John,Doe,1980-01-01,M
67890,Jane,Smith,1975-05-15,F`;

fetch('https://demo.redix.com/api/v2/convert/smart', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ content: csvData })
})
.then(res => res.json())
.then(result => {
    if (result.success) {
        console.log('✓ Converted:', result.output);
    } else {
        console.error('✗ Error:', result.error);
    }
});

Response Format:

{
  "success": true,
  "conversion_type": "hipaa-x12",
  "output": {
    // Converted output (JSON, XML, or other format based on conversion rules)
    // Format depends on the output configuration in .cfg file
  },
  "metadata": {
    "input_format": "X12/HIPAA",
    "conversion_applied": "837p_professional",
    "timestamp": "2024-01-01T12:00:00Z"
  }
}

Endpoint:

Description:

Detect the format of input data without performing conversion. Returns detected format type and confidence level.

Example Request:

curl -X POST https://demo.redix.com/api/v2/detect \
  -H "Content-Type: application/json" \
  -d '{
    "content": "MSH|^~\\&|SendApp|SendFac|RecApp|RecFac|20240101120000||ADT^A01|123456|P|2.5"
  }'

Response:

{
  "success": true,
  "detected_format": "HL7",
  "message_type": "ADT",
  "confidence": "high",
  "details": {
    "version": "2.5",
    "encoding_characters": "^~\\&",
    "message_control_id": "123456"
  }
}

🏥 Healthcare Interoperability

Convert legacy HL7 messages and CDA documents to FHIR for modern EHR integration.

💳 Claims Processing

Transform HIPAA X12 837 claims to JSON for analytics, or convert database extracts to 837 for submission.

📊 Data Migration

Batch convert thousands of files during system migrations - HL7, CDA, X12, CSV, XML, and more.

🔄 Real-time Integration

Process incoming data streams in real-time - lab results, eligibility checks, claim status updates.

📈 Analytics & Reporting

Convert healthcare transactions to structured JSON/FHIR for business intelligence and reporting.

🌐 International Exchange

Transform between US HIPAA and international EDIFACT/RMap formats for global partnerships.

HTTP Status Codes:

Error Response Format:

{
  "success": false,
  "error": "Could not detect message type from MSH-9 field",
  "error_type": "ValidationError",
  "details": {
    "field": "MSH-9",
    "expected": "Message type code (e.g., ADT^A01)",
    "received": "null"
  }
}

Best Practices:

• Always check the success field in responses
• Use format detection endpoint first for unknown data types
• Implement retry logic with exponential backoff for 5xx errors
• Validate input data before sending to reduce 400 errors
• Log error details for troubleshooting