---
title: "Create Charges Into ModMedPM"
method: POST
path: "/fhir/v2/ChargeItem"
tags: ["Charges/Financial"]
---

# Create Charges Into ModMedPM

`POST /fhir/v2/ChargeItem`

## Request

- Base URL: `https://stage.ema-api.com/ema-dev/firm/apiportal/ema`
- URL: `https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ChargeItem`
- Auth: HTTP bearer and API key in header `x-api-key`

Submit charges from an external billing system into ModMed PM. Each ChargeItem represents one transaction and may contain multiple `financialTransactionDetail` lines — one per CPT/HCPCS code billed.

**Billing pattern — fee schedule vs explicit costs:** Most integrations omit `totalCost` and `unitCost`. In that case ModMed PM looks up the applicable fee schedule and calculates the charge amounts automatically. Include `totalCost` at the transaction level and `unitCost` per line only when the sending system needs to override the fee schedule with explicit dollar amounts (for example, pathology or DME vendors that supply their own cost breakdown).

**Key fields:**
- `sendingFacility` / `receivingFacility` — identify the sending system and the target ModMed practice (firm prefix).
- `transactionId` — a unique identifier from the sending system; used to detect duplicate submissions.
- `attendingProviderId` — the supervising or attending provider for the encounter.
- `performingProviderId` (per line) — the provider who performed each procedure; may differ from attending.
- `orderingProviderId` (per line, optional) — the ordering or referring provider for that procedure line.

## Request body

- FHIRJSONRESOURCE: A FHIR resource

## Response `200`

Success

- FHIRJSONRESOURCE: A FHIR resource

## Other responses

- `201`: Created
- `400`: BAD REQUEST - The request was bad, often due to a missing required parameter
- `401`: NOT AUTHORIZED - Authentication error; this token is not allowed access to the API
- `403`: FORBIDDEN
- `404`: NOT FOUND
- `422`: UNPROCESSABLE ENTITY - Request could not be processed; typically a validation error
- `429`: TOO MANY REQUESTS - Request was rate limited (1000 calls/min default); please retry
- `500`: SERVER ERROR - Internal Server Error

---

[API](https://skmtc.dev/modmed/apis/ema-proprietary-api.md) - [All operations](https://skmtc.dev/modmed/apis/ema-proprietary-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modmed/apis/ema-proprietary-api/revisions/c03c1956a05d?raw)