---
title: "Create Charge"
method: POST
path: "/provider/charges"
tags: ["Charge"]
---

# Create Charge

`POST /provider/charges`

## Request body

- ProviderChargesControllerCreateBody
  - `charge_item` ChargeItem, required
    - `id` string, required — Optional if name, code and code_type are specified
    - `name` string, required — Required if no ID
    - `code` string, required — Required if no ID
    - `code_type` 'cpt' | 'ndc' | 'loinc' | 'snomed' | 'proprietary', required — Required if no ID. Use 'proprietary' for non-standard codes, namespaced as '<namespace>:<code>' (e.g. 'acmelab:LP12345').
    - `manufacturer` string
    - `days_supply` integer
  - `patient` Association, required
    - `id` string, required
  - `quantity` integer
  - `price_in_cents` number, double
  - `description` string
  - `date` string, date
  - `category` Category
    - `id` string, required — Optional if type is specified
    - `type` 'memberships' | 'labs' | 'medications' | 'vitamins_and_supplements' | 'vaccines' | 'imaging' | 'supplies_and_dme' | 'retail_items' | 'office_visits' | 'procedures' | 'fees', required — Ignored if ID is specified
  - `practitioner` Association
    - `id` string, required
  - `location` Association
    - `id` string, required

## Response `201`

Successful response

- PublicChargeBlueprintOneWithInvoice
  - `id` string
  - `amount_in_cents` integer
  - `created_at` string, date-time
  - `description` string
  - `is_persisted` boolean
  - `name` string
  - `price_in_cents` integer
  - `quantity` integer
  - `service_date` string, date
  - `status` string
  - `subtotal_in_cents` integer
  - `tax_in_cents` integer
  - `total_in_cents` integer
  - `updated_at` string, date-time
  - `category` PublicCategoryBlueprintOne
    - `id` string
    - `name` string
    - `created_at` string, date-time
    - `default_for_memberships` boolean
  - `charge_item` PublicChargeItemBlueprintOne
    - `id` string
    - `code` string
    - `description` string
    - `name` string
    - `provider_web_link` string
    - `created_at` string, date-time
    - `price_in_cents` number, float
    - `quantity_in_stock` integer
    - `updated_at` string, date-time
    - `category` PublicCategoryBlueprintOne
      - `id` string
      - `name` string
      - `created_at` string, date-time
      - `default_for_memberships` boolean
  - `invoice` PublicPayableInvoiceBlueprintOne
    - `id` string
    - `amount_in_cents` integer
    - `date` string, date
    - `human_status` string
    - `invoice_number` string
    - `status` string
    - `type` string
    - `url` string
  - `location` PublicLocationBlueprintShared
    - `id` string
    - `address_city` string
    - `address_country` string
    - `address_line1` string
    - `address_line2` string
    - `address_state` string
    - `address_zip` string
    - `name` string
  - `patient` PublicPatientBlueprintOne
    - `id` string
    - `address_city` string
    - `address_country` string
    - `address_line1` string
    - `address_line2` string
    - `address_state` string
    - `address_zip` string
    - `age` string
    - `chosen_first_name` string
    - `chosen_last_name` string
    - `chosen_middle_name` string
    - `chosen_suffix` string
    - `chosen_title` string
    - `created_at` string, date-time
    - `dob` string, date
    - `electronic_communication_consent_accepted` string
    - `electronic_communication_consent_accepted_at` string
    - `email` string
    - `engaged` boolean
    - `external_link_id` string
    - `first_name` string
    - `gender` string
    - `gender_identity` string
    - `gender_other` string
    - `health_insurance_group_id` string
    - `health_insurance_member_id` string
    - `health_insurance_payer_id` string
    - `health_insurance_payer_name` string
    - `hipaa_authorization_accepted` boolean
    - `hipaa_authorization_accepted_at` string, date-time
    - `import_id` string
    - `import_source` string
    - `joined_practice_date` string, date
    - `last_engagement_date` string, date
    - `last_name` string
    - `lead_source_other` string
    - `master_record_sponsor` string
    - `membership_status` string
    - `middle_name` string
    - `name` string
    - `patient_agreement_accepted` boolean
    - `patient_agreement_accepted_at` string, date-time
    - `preferred_language` string
    - `pronouns` string
    - `provider_web_link` string
    - `sex` string
    - `suffix` string
    - `terms_accepted` boolean
    - `terms_accepted_at` string, date-time
    - `updated_at` string, date-time
    - `uses_tobacco` boolean
    - `account` PublicPatientBlueprintAccount
      - `name` string
      - `past_due_in_cents` integer
    - `company` PublicCompanyBlueprintLeaf
      - `id` string
      - `name` string
    - `emergency_contact` CommonEmergencyContactBlueprintShared
      - `id` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `name` string
      - `relationship` string
      - `relationship_other` string
      - `phone` CommonPhoneBlueprintShared
        - `number` string
        - `type` string
        - `us_formattable` string
    - `external_records` PublicExternalRecordBlueprintMin
      - `source` string
      - `external_id` string
    - `known_practice` PublicKnownPracticeBlueprintMin
      - `id` string
      - `name` string
    - `lead_source` PublicLeadSourceBlueprintOne
      - `id` string
      - `name` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `location` PublicLocationBlueprintOne
      - `id` string
      - `address_city` string
      - `address_country` string
      - `address_latitude` number, float
      - `address_line1` string
      - `address_line2` string
      - `address_longitude` number, float
      - `address_state` string
      - `address_zip` string
      - `distance` string
      - `name` string
      - `phone_number` string
      - `virtual` boolean
      - `location_group` PublicLocationGroupBlueprintLeaf
        - `id` string
        - `created_at` string, date-time
        - `integration_record_id` string
        - `name` string
        - `updated_at` string, date-time
    - `location_group` PublicLocationGroupBlueprintLeaf
      - `id` string
      - `created_at` string, date-time
      - `integration_record_id` string
      - `name` string
      - `updated_at` string, date-time
    - `membership_members` PublicMembershipMemberBlueprintForPatient
      - `id` string
      - `enrollment_status` string
      - `member_type` string
      - `status` string
      - `enrollment_requested_on` string, date
      - `start_date` string, date
      - `end_date` string
      - `membership` PublicMembershipBlueprintMin
        - `id` string
    - `memberships` PublicMembershipPatientBlueprintOne
      - `end_date` string
      - `enrollment_requested_on` string, date
      - `enrollment_status` string
      - `member_type` string
      - `start_date` string, date
      - `status` string
      - `uses_tobacco` boolean
      - `company` PublicCompanyBlueprintLeaf
        - `id` string
        - `name` string
      - `division` PublicEmployeeDivisionBlueprintLeaf
        - `id` string
        - `name` string
      - `payer` PublicPatientBlueprintMin
        - `id` string
        - `name` string
      - `plan` PublicPlanBlueprintMin
        - `id` string
        - `name` string
        - `plan_type` string
    - `merged_into` PublicPatientBlueprintMin
      - `id` string
      - `name` string
    - `phones` PublicPhoneBlueprintLeaf
      - `number` string
      - `type` string
    - `practitioner` PublicPractitionerBlueprintOne
      - `id` string
      - `accepts_enrollments_from_employer` string
      - `accepts_enrollments_from_retail` string
      - `bio` string
      - `created_at` string, date-time
      - `education` string
      - `email` string
      - `gender` string
      - `gender_other` string
      - `integration_record_id` string
      - `max_patient_age` string
      - `min_patient_age` string
      - `name` string
      - `online_signup_visibility` string
      - `panel_size` integer
      - `panel_size_limit` integer
      - `photo_url` string
      - `updated_at` string, date-time
      - `locations` PublicLocationBlueprintOne[]
        - `id` string
        - `address_city` string
        - `address_country` string
        - `address_latitude` number, float
        - `address_line1` string
        - `address_line2` string
        - `address_longitude` number, float
        - `address_state` string
        - `address_zip` string
        - `distance` string
        - `name` string
        - `phone_number` string
        - `virtual` boolean
        - `location_group` PublicLocationGroupBlueprintLeaf
          - `id` string
          - `created_at` string, date-time
          - `integration_record_id` string
          - `name` string
          - `updated_at` string, date-time
      - `npi` PublicNpiBlueprintShared
        - `first_name` string
        - `last_name` string
        - `number` string
        - `organization_name` string
        - `type` string
      - `specialties` PublicSpecialtyBlueprintAll[]
        - object[]
          - `id` string
          - `name` string
    - `practitioner_group` PublicLocationGroupBlueprintLeaf
      - `id` string
      - `created_at` string, date-time
      - `integration_record_id` string
      - `name` string
      - `updated_at` string, date-time
    - `sponsorships` PublicCompanySponsorshipBlueprintForPatient
      - `id` string
      - `external_id` string
      - `is_subscriber` boolean
      - `type` string
      - `company` PublicCompanyBlueprintLeaf
        - `id` string
        - `name` string
      - `family` PublicCompanyAccountBlueprintMin
        - `id` string
    - `ssn` CommonSocialSecurityNumberBlueprintMasked
      - `masked_number` string
  - `practitioner` PublicPractitionerBlueprintOne
    - `id` string
    - `accepts_enrollments_from_employer` string
    - `accepts_enrollments_from_retail` string
    - `bio` string
    - `created_at` string, date-time
    - `education` string
    - `email` string
    - `gender` string
    - `gender_other` string
    - `integration_record_id` string
    - `max_patient_age` string
    - `min_patient_age` string
    - `name` string
    - `online_signup_visibility` string
    - `panel_size` integer
    - `panel_size_limit` integer
    - `photo_url` string
    - `updated_at` string, date-time
    - `locations` PublicLocationBlueprintOne[]
      - `id` string
      - `address_city` string
      - `address_country` string
      - `address_latitude` number, float
      - `address_line1` string
      - `address_line2` string
      - `address_longitude` number, float
      - `address_state` string
      - `address_zip` string
      - `distance` string
      - `name` string
      - `phone_number` string
      - `virtual` boolean
      - `location_group` PublicLocationGroupBlueprintLeaf
        - `id` string
        - `created_at` string, date-time
        - `integration_record_id` string
        - `name` string
        - `updated_at` string, date-time
    - `npi` PublicNpiBlueprintShared
      - `first_name` string
      - `last_name` string
      - `number` string
      - `organization_name` string
      - `type` string
    - `specialties` PublicSpecialtyBlueprintAll[]
      - object[]
        - `id` string
        - `name` string

---

[API](https://skmtc.net/hint/apis/partner-endpoints.md) · [All operations](https://skmtc.net/hint/apis/partner-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hint/partner-endpoints/revisions/a92ae2a6fa90/schema)
