Office Ally

Supergood | Office Ally API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Office Ally API

Office Ally is software that helps medical practices submit insurance claims, verify patient eligibility, manage appointments and charges, and run a cloud EHR. With an unofficial API, you could programmatically sync patients and insurance data, create and submit 837 claims, run real-time 270 eligibility checks, and pull 835 remittances for automated posting—without manual portal work.

If you’re a healthcare tech startup building billing, practice management, or provider tooling, integrating with Office Ally means you can pull patient demographics, insurance policies, appointments, eligibility responses, claim statuses, and ERAs; push new patients, updated insurance, charges/superbills, and claims; and build features like eligibility-aware scheduling, automatic claim assembly, real-time rejection handling, and remittance reconciliation.

Programmatically access clearinghouse, eligibility, claims, and practice management workflows in Office Ally with a stable REST API. Supergood builds and operates production-grade, unofficial Office Ally integrations so your team can automate critical billing and RCM pipelines without heavy custom engineering.

Office Ally is used by medical practices, billing services, and provider groups to manage claims submission to thousands of payers, verify patient coverage, receive electronic remittances, and run practice and EHR workflows. With an unofficial API, you could sync patients and insurance from your EHR/PM, verify coverage before visits, assemble and submit 837P/I claims, track clearinghouse acknowledgments, and reconcile payments with ERA—all end to end.

If you’re a clinic, provider group, or revenue cycle team, integrating your tech stack with Office Ally unlocks concrete data flows and features:

  • Pull: Patient profiles, insurance policies, appointment schedules, superbills/charges, payer enrollments, claim statuses (999/277), ERA summaries (835), clearinghouse reports
  • Push: New/updated patients and insurance from your EHR, scheduled appointments, charge capture/superbills, professional/institutional claims (837P/I), corrected/voided claims
  • Build: Eligibility-aware scheduling and charge entry, automated claim assembly and submission, real-time rejection worklists, remittance-driven posting and reconciliation

What is Office Ally?

Office Ally provides a nationwide clearinghouse, practice management (Practice Mate), cloud EHR (EHR 24/7), patient portal (Patient Ally), and related RCM tools that help practices submit claims, check eligibility, receive ERAs, and manage daily operations. Core products include:

  • Clearinghouse (837P/I submission, 276/277 claim status, 835 ERA, payer enrollments)
  • Practice Mate (appointments, demographics, insurance, charge entry, statements)
  • EHR 24/7 (clinical documentation, orders, charting, e-prescribing via integrated services)
  • Patient Ally (patient portal for intake, messages, scheduling)
  • Reporting and payer connectivity

Common data entities:

  • Patients and guarantors
  • Insurance policies (primary/secondary/tertiary)
  • Providers and facilities (NPI, taxonomy, address)
  • Appointments and schedules
  • Superbills/charges and diagnosis codes
  • Claims (837 professional/institutional) and attachments when required
  • Payers and enrollment statuses (ERA/EFT)
  • Eligibility requests/responses (270/271)
  • Claim acknowledgments (999/277) and clearinghouse reports
  • Remittances (835) and payment posting

The Office Ally Integration Challenge

Organizations rely on Office Ally daily, but turning portal-based clearinghouse and PM/EHR workflows into automated pipelines is hard:

  • EDI complexity: 837/270/271/276/277/835 formats, payer-specific rules, and ICD/CPT/HCPCS/POA modifiers must be assembled correctly
  • Payer enrollments: ERA/EFT and claim submission routing require enrollment steps and status tracking before automated submission
  • Strong enterprise security: SSO/MFA and network controls complicate headless automation across Practice Mate, EHR 24/7, and the Clearinghouse
  • Portal-first delivery: Key eligibility, claim acknowledgments, and remittance artifacts are available in web apps or batch exports, not unified public APIs
  • Batch timing and acknowledgments: Submission windows, 999/277 acknowledgment sequences, and ERA availability require careful orchestration
  • Corrections and audit: Replacement/void claims, appeal workflows, and audit trails must be handled with compliance in mind

How Supergood Creates Office Ally APIs

Supergood reverse-engineers authenticated browser flows, batch interfaces, and network interactions to deliver a resilient API endpoint layer.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes patient, insurance, claim, eligibility, and ERA objects across Office Ally products
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports and SFTP/EDI flows with signed URL retrieval and delivery where applicable
  • Tracks payer enrollment statuses to enforce routing and reduce submission errors

Use Cases

EHR/PM Synchronization

  • Push patient demographics and insurance policies from your EHR/PM into Practice Mate
  • Import charges/superbills and create claims with accurate diagnosis/procedure codes
  • Maintain a single source of truth for patient and insurance data across systems

Eligibility-Aware Scheduling and Charge Entry

  • Run real-time 270 eligibility checks before appointments
  • Surface copays, deductibles, and coverage limits at point of scheduling and charge capture
  • Prevent out-of-network or inactive policy submissions

Claims Generation and Submission

  • Assemble 837P/I claims from charges and submit via the Clearinghouse
  • Track 999/277 acknowledgments and route rejections to worklists
  • Manage corrected/replacement claims with appropriate reference numbers

Remittance Reconciliation

  • Pull ERAs (835) and post payments automatically to your PM/EHR
  • Map CARC/RARC codes to adjustments and denial categories
  • Reconcile bank deposits/EFT with payer remittance files

Enrollment and Routing

  • Monitor payer enrollment statuses (ERA/EFT, claim submission)
  • Enforce routing logic based on payer and product requirements
  • Proactively surface missing enrollments to avoid submission delays

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": {
      "type": "totp",
      "code": "123456"
    }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_1f83b2",
    "name": "Billing Admin",
    "entitlements": ["clearinghouse", "practice_mate", "ehr_24_7"]
  }
}

Patients

GET /patients: Retrieve patient demographics, insurance policies, and contact information from Practice Mate/EHR 24/7. Use filters to sync rosters incrementally.

Query parameters

  • dob: ISO 8601 date
  • updatedSince: ISO 8601 datetime
  • insurancePayerId: string
  • page: number
  • pageSize: number

Example response

{
  "items": [
    {
      "patientId": "pat_82c91a",
      "mrn": "PM-100234",
      "firstName": "Ava",
      "lastName": "Ramirez",
      "dob": "1987-05-09",
      "sex": "F",
      "phone": "+1-503-555-0199",
      "email": "[email protected]",
      "address": {
        "line1": "123 Main St",
        "city": "Portland",
        "region": "OR",
        "postalCode": "97205"
      },
      "insurancePolicies": [
        {
          "policyId": "ins_77e210",
          "payerId": "payer_bcbs-or",
          "planName": "BCBS PPO",
          "memberId": "X123456789",
          "groupNumber": "G-55678",
          "isPrimary": true,
          "effectiveDate": "2025-01-01",
          "terminationDate": null
        }
      ],
      "guarantor": {
        "name": "Ava Ramirez",
        "relationship": "self"
      },
      "updatedAt": "2026-01-19T15:22:10Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Optionally create/update patients

POST /patients: Create or update patient records and insurance policies.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/patients \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "firstName": "Noah",
    "lastName": "Kim",
    "dob": "1990-11-22",
    "sex": "M",
    "phone": "+1-206-555-0124",
    "address": {"line1": "45 Lakeview Ave", "city": "Seattle", "region": "WA", "postalCode": "98101"},
    "insurancePolicies": [
      {"payerId": "payer_regence-wa", "planName": "Regence PPO", "memberId": "R99887766", "groupNumber": "RG-2201", "isPrimary": true, "effectiveDate": "2026-01-01"}
    ]
  }'

Example response

{
  "patientId": "pat_9ac330",
  "status": "created",
  "updatedAt": "2026-01-19T16:01:03Z"
}

Eligibility

POST /eligibility: Initiate a 270 request to verify coverage for a specific date of service. Returns a normalized 271 summary with copays, deductibles, and plan details.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/eligibility \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "patientId": "pat_82c91a",
    "payerId": "payer_bcbs-or",
    "dateOfService": "2026-01-20",
    "serviceTypeCodes": ["30"],
    "referenceId": "appt-20391"
  }'

Example response

{
  "eligibilityId": "elig_4f2ab1",
  "status": "eligible",
  "plan": {
    "planName": "BCBS PPO",
    "network": "PPO",
    "effectiveDate": "2025-01-01"
  },
  "benefits": {
    "copay": {"officeVisit": 25.0},
    "coinsurance": 0.2,
    "deductible": {"remaining": 350.0, "annual": 1000.0}
  },
  "limitations": {"outOfNetwork": false},
  "raw271": {"size": 10492},
  "referenceId": "appt-20391"
}

Claims

POST /claims: Assemble and submit an 837P/I claim from charges/superbills. Supergood normalizes segments and routes the generated file to the configured submission channel.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "claimType": "837P",
    "payerId": "payer_bcbs-or",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "207Q00000X",
      "name": "River City Medical Group",
      "billingAddress": {"line1": "200 Clinic Way", "city": "Portland", "region": "OR", "postalCode": "97205"}
    },
    "renderingProvider": {"npi": "1098765432", "name": "Dr. Elena Gupta"},
    "patient": {"patientId": "pat_82c91a"},
    "subscriber": {"memberId": "X123456789", "relationship": "self"},
    "placeOfService": "11",
    "diagnosisCodes": ["J02.9", "Z00.00"],
    "serviceLines": [
      {"cptCode": "99213", "modifiers": ["25"], "units": 1, "chargeAmount": 125.0, "diagnosisPointers": [1]},
      {"cptCode": "87880", "units": 1, "chargeAmount": 35.0, "diagnosisPointers": [1]}
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "sb-45122"
  }'

Example response

{
  "claimId": "clm_71af2b",
  "status": "queued",
  "edi": {"format": "837P", "size": 56321},
  "clearinghouseTraceNumber": "CH-OR-20260119-000154",
  "acknowledgments": {"expected": ["999", "277"]},
  "createdAt": "2026-01-19T16:05:42Z",
  "reviewUrl": "https://download.officeally.example/signed/abc123...",
  "referenceId": "sb-45122"
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination
  • Rate limits: Tuned for enterprise throughput while honoring licensing and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of eligibility, claims, acknowledgments, and remittance artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Office Ally entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for acknowledgments, remittances, and rejection updates

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume eligibility checks and batch claims pipelines
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your Office Ally product mix (Practice Mate, EHR 24/7, Clearinghouse), licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Office Ally adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Office Ally evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Office Ally products can this integration cover?

Supergood supports workflows across Office Ally’s Clearinghouse, Practice Mate, EHR 24/7, and Patient Ally, subject to your licensing and entitlements. We scope eligibility (270/271), claims (837P/I), acknowledgments (999/277), remittances (835), and roster/appointment sync during integration assessment.

Q: How are MFA, SSO, and batch interfaces handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For batch flows, we manage EDI timing windows, generate 837 files, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate claims directly from charges in my PM/EHR?

Yes. You can assemble 837P/I from superbills and charges with payer-specific formatting. We route submissions via the Clearinghouse and return acknowledgments and artifacts for reconciliation.

Availity API - Programmatically access the Availity clearinghouse with Supergood

Ready to automate your Office Ally workflows?

Supergood can have your Office Ally integration live in days with no ongoing engineering maintenance.

Get Started →

Read more