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

# Create Charges Into ModMedPM

`POST /fhir/v2/ChargeItem`

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.

## Response `200`

Success

## 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.net/modmed/apis/ema-proprietary-api-authentication.md) · [All operations](https://skmtc.net/modmed/apis/ema-proprietary-api-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modmed/ema-proprietary-api-authentication/revisions/2c8b6a756f84/schema)