​

API Overview

​

Platform Capabilities

• Deploy AI assistants that handle patient calls, scheduling, and inquiries 24/7
• Automate note-taking and clinical documentation with AI-powered transcription
• Intelligent patient communication with multi-language support

• Accept payments online, in-person, and over the phone
• Support multiple payment methods: credit/debit cards, ACH/eCheck, HSA/FSA, gift cards, and mobile wallets
• Handle complex billing workflows: refunds, adjustments, write-offs, discounts, payment plans, and insurance payments
• Integrate with point-of-sale systems for seamless in-clinic transactions

• Complete patient lifecycle management from intake to follow-up
• Patient communication hub with two-way texting, calling, and email
• Intelligent scheduling with automated reminders and confirmations
• Form management and intake workflows
• Patient document and attachment handling

• Calendar and appointment management
• Provider and staff management with role-based access control
• Inventory and stock management
• Commission structures and reporting
• Analytics and reporting dashboards

• AI-powered note creation and transcription
• Note templates and versioning
• Clinical attachments and annotations
• Integration with medical coding (CPT, ICD-10)

​

API Organization

• Patients - Create, search, and manage patient records
• Patient Documents - Upload, share, and sign off on patient documents
• Patient Tags - Organize patients with custom tags
• Patient Notes - Quick notes pinned to a patient
• Patient Measurements - Record measurements, goals, and trends
• Care Plans - Build and track patient care plans
• Patient Insurance - Manage patient insurance coverages
• Patient Credit - Track and transfer patient credit balances
• Loyalty Points - Grant and redeem loyalty points
• Patient Payment Methods - Store and remove patient payment methods
• Patient Doses - Log and sign off on administered doses
• Patient Import - Bulk-import patients via CSV and column mappings

• Charges - Create and manage charges, superbill context, and reversals
• Invoices - Issue, send, and reconcile invoices
• Payments - Card, cash, credit, loyalty, and insurance payments plus refunds
• Payment Plans - Installment plans and scheduled payments
• Payment Terminals - In-person, point-of-sale terminal charges
• Payment Links - Shareable hosted payment links
• Carts - Build carts and convert them to charges
• Quotes - Create, send, and convert customer quotes
• Discounts - Patient and package discounts
• Promotions - Promotion setup, evaluation, and redemption
• Gift Cards - Issue, validate, and redeem gift cards
• Adjustments and Write-Offs - Charge adjustments and write-offs
• Superbills - Generate and send patient superbills
• Tips - Tip capture and terminal tip displays
• Chargebacks - Manage and respond to chargebacks
• Merchant Accounts - Merchant account configuration

• Items - Sellable items and services
• Packages - Multi-item packages
• Memberships - Membership plans and enrolled members
• Suppliers - Inventory suppliers
• Stock - Stock levels, transfers, counts, and barcodes
• Purchasing - Purchase orders and inbound shipments

• Opportunities - Leads and opportunities pipeline
• Campaigns - Marketing campaigns, posts, budgets, and goals
• Pipelines - Sales pipelines, stages, and templates
• Marketing Platforms - Connect and sync external ad platforms
• Growth Agents - AI growth agents and their runs
• Growth Analytics - Campaign performance and growth dashboards

• Calendar and Appointments - Appointment scheduling and event management
• Forms - Intake forms and form submissions
• Attachments - File and document management
• Medications - Medication catalog management
• Medical Codes - CPT and ICD-10 code lookup

• Tenant - Tenant configuration and API key management
• Webhooks - Webhook configuration and event delivery

​

Getting Started

​

Base URL

https://api.decodahealth.com

​

Authentication

• API-KEY: Your API key (obtained from Decoda Health)
• TENANT: Your tenant identifier

curl -X GET "https://api.decodahealth.com/tenant/public" \
     -H "API-KEY: YOUR_API_KEY" \
     -H "TENANT: YOUR_TENANT"

import requests

response = requests.get(
    "https://api.decodahealth.com/tenant/public",
    headers={
        "API-KEY": "YOUR_API_KEY",
        "TENANT": "YOUR_TENANT"
    }
)

import ky from "ky";

const response = await ky.get("https://api.decodahealth.com/tenant/public", {
  headers: {
    "API-KEY": "YOUR_API_KEY",
    "TENANT": "YOUR_TENANT",
  },
});

​

Getting Your API Key

1. Go to Settings → Developers → API & Webhooks. (Tip: open search with ⌘K / Ctrl+K and type “API & Webhooks”.)
2. In the API Access section, click Generate New API Key.
3. Copy the key and store it somewhere secure — you won’t be able to view it in full again.

• Never expose your API key in client-side code or public repositories
• Rotate API keys regularly
• Use environment variables to store API keys securely
• Monitor API usage and set up alerts for unusual activity

​

API Versioning

​

Rate Limits

• X-RateLimit-Limit: Maximum number of requests allowed
• X-RateLimit-Remaining: Number of requests remaining in the current window
• X-RateLimit-Reset: Time when the rate limit resets

​

Webhooks

​

Error Handling

• 2xx: Success
• 4xx: Client error (invalid request, authentication failure, etc.)
• 5xx: Server error

{
  "detail": "Error message describing what went wrong"
}

​

Support

• Email: support@decodahealth.com
• Documentation: This site contains comprehensive API reference documentation
• Status: Check our status page for API availability and incidents

​

Next Steps

• Explore the API Reference to see all available endpoints
• Start with the Patients endpoints — patient records are the core of most integrations
• Set up Webhooks to receive real-time notifications
• Use the Charges and Payments endpoints for payment processing