---
title: "Update current patient statement."
method: POST
path: "/practices/{practice_id}/patients/{patient_id}/statement"
tags: ["statements"]
---

# Update current patient statement.

`POST /practices/{practice_id}/patients/{patient_id}/statement`

## Request

- Base URL: `sandbox.collectly.co/api/api/partners/v1` (relative, and the document’s source URL is not known)
- URL: `sandbox.collectly.co/api/api/partners/v1/practices/{practice_id}/patients/{patient_id}/statement`
- Auth: API key in header `Authorization`

POSTing a statement will create a new billing cycle for a patient in case there were no active billing cycle yet (patient balance was <= zero). Please pass only IDs for connected entities, not the full objects: patient_id, location_id, provider_id

## Path parameters

- `practice_id` string, required
- `patient_id` string, required

## Request body

- SnapshotPartner
  - `allowed_amount` number, nullable
  - `billed_amount` number, nullable
  - `created_at` unknown
  - `data` SnapshotData
    - `balance_past_120_days` number, nullable
    - `payments` SnapshotPayment[]
      - `allocations` SnapshotPaymentAllocation[]
        - `amount` number, required
        - `charge_id` string
        - `id` string, required
        - `visit_id` string
      - `amount` number, required
      - `collectly_id` string
      - `id` string, required
      - `payment_type` 'payment' | 'copay' | 'refund' | 'part_ref' | 'autodeb' | 'collect'
      - `post_date` string, date: ISO-8601 date format
      - `source_payment_id` string
    - `visits` SnapshotVisit[]
      - `adjustment` unknown
      - `allowed_amount` number
      - `appointment` SnapshotAppointment
        - `external_id` string
        - `id` integer
      - `billed_amount` number
      - `billing_hold_reason` 'not_billable_financial_class' | 'active_subscription_cycle' | 'bad_debt' | 'candid_excluded_payer' | 'excluded_cpt_code' | 'excluded_tag', nullable
      - `billing_hold_type` 'pending' | 'archived' | 'disabled_location' | 'disabled_provider' | 'written_off', nullable
      - `billing_location` SnapshotLocation
        - `data` object
        - `external_id` string, nullable
        - `id` integer
        - `name` string
        - `tax_id` string, nullable
      - `billing_provider` VisitProvider
        - `display_name` string
        - `external_id` string
        - `first_name` string, nullable
        - `id` integer
        - `last_name` string, nullable
      - `charges` SnapshotVisitCharge[]
        - `adjustment` unknown
        - `allowed_amount` number, nullable
        - `billed_amount` number, nullable
        - `description` string, nullable
        - `id` string, required
        - `ins_paid` number, nullable
        - `note` string, nullable
        - `procedure_code` string, nullable
        - `pt_adjustment` number, nullable
        - `pt_amount` number, nullable
        - `pt_balance` number, nullable
        - `pt_paid` number, nullable
        - `rx_number` string, nullable
      - `collections_status` string, nullable
      - `discounts` Discount[]
        - `amount` number, nullable
        - `description` string
        - `external_id` string, nullable
        - `valid_until` string, date, nullable
      - `ehr_discounts` Discount[]
        - `amount` number, nullable
        - `description` string
        - `external_id` string, nullable
        - `valid_until` string, date, nullable
      - `external_id` string
      - `id` string, required
      - `ins_paid` number
      - `insurance_payments` InsurancePayment[], nullable
        - `adjustment` number, nullable
        - `allowed_amount` number, nullable
        - `coins_amount` number, nullable
        - `company_external_id` string, nullable
        - `date` string, date, nullable
        - `deduct_amount` number, nullable
        - `external_id` string
        - `extra` object, nullable
        - `ins_paid` number, nullable
        - `member_balance` number, nullable
        - `withheld_amount` number, nullable
      - `insurance_policies` VisitInsurancePolicy[], nullable
        - `company_external_id` string, nullable
        - `group_id` string
        - `insurance_name` string
        - `member_id` string
        - `policy_external_id` string, nullable
        - `priority` 'primary' | 'secondary' | 'tertiary' | 'other'
        - `state` InsurancePolicyState
          - `claim_adjustments` Adjustment[]
            - `amount` number, required
            - `group` string, required
            - `reason` string, required
          - `claim_status` string
          - `claim_status_description` string
          - `codes_description` string[]
          - `line_items` ERALineItem[]
            - `adjustments` Adjustment[]
              - …
            - `allowed` number, nullable
            - `billed` number, required
            - `paid` number, required
            - `remark` string, nullable
            - `service_code` string, required
            - `service_date_end` string, date, nullable
            - `service_date_start` string, date, nullable
            - `units` integer, nullable
      - `location` Location
        - `collectly_id` string
        - `id` string, required
        - `name` string
      - `location_id` string, nullable, required
      - `meta` unknown
      - `notes` string[], nullable
      - `patient_name` string, nullable
      - `provider` Provider
        - `collectly_id` string
        - `first_name` string
        - `id` string, required
        - `last_name` string
      - `provider_id` string, nullable, required
      - `pt_adjustment` number
      - `pt_amount` number
      - `pt_bad_debt` number, nullable
      - `pt_balance` number
      - `pt_balance_on_hold` number
      - `pt_paid` number
      - `raw_adjustments` object[], nullable
      - `service_date` string, date, required
      - `visit_pt_adjustment` number
  - `id` integer
  - `ins_paid` number, nullable
  - `modified_at` unknown
  - `patient_id` string
  - `practice_id` string, required
  - `pt_amount` number
  - `pt_balance` number

## Response `200`

OK

- SnapshotPartner
  - `allowed_amount` number, nullable
  - `billed_amount` number, nullable
  - `created_at` unknown
  - `data` SnapshotData
    - `balance_past_120_days` number, nullable
    - `payments` SnapshotPayment[]
      - `allocations` SnapshotPaymentAllocation[]
        - `amount` number, required
        - `charge_id` string
        - `id` string, required
        - `visit_id` string
      - `amount` number, required
      - `collectly_id` string
      - `id` string, required
      - `payment_type` 'payment' | 'copay' | 'refund' | 'part_ref' | 'autodeb' | 'collect'
      - `post_date` string, date: ISO-8601 date format
      - `source_payment_id` string
    - `visits` SnapshotVisit[]
      - `adjustment` unknown
      - `allowed_amount` number
      - `appointment` SnapshotAppointment
        - `external_id` string
        - `id` integer
      - `billed_amount` number
      - `billing_hold_reason` 'not_billable_financial_class' | 'active_subscription_cycle' | 'bad_debt' | 'candid_excluded_payer' | 'excluded_cpt_code' | 'excluded_tag', nullable
      - `billing_hold_type` 'pending' | 'archived' | 'disabled_location' | 'disabled_provider' | 'written_off', nullable
      - `billing_location` SnapshotLocation
        - `data` object
        - `external_id` string, nullable
        - `id` integer
        - `name` string
        - `tax_id` string, nullable
      - `billing_provider` VisitProvider
        - `display_name` string
        - `external_id` string
        - `first_name` string, nullable
        - `id` integer
        - `last_name` string, nullable
      - `charges` SnapshotVisitCharge[]
        - `adjustment` unknown
        - `allowed_amount` number, nullable
        - `billed_amount` number, nullable
        - `description` string, nullable
        - `id` string, required
        - `ins_paid` number, nullable
        - `note` string, nullable
        - `procedure_code` string, nullable
        - `pt_adjustment` number, nullable
        - `pt_amount` number, nullable
        - `pt_balance` number, nullable
        - `pt_paid` number, nullable
        - `rx_number` string, nullable
      - `collections_status` string, nullable
      - `discounts` Discount[]
        - `amount` number, nullable
        - `description` string
        - `external_id` string, nullable
        - `valid_until` string, date, nullable
      - `ehr_discounts` Discount[]
        - `amount` number, nullable
        - `description` string
        - `external_id` string, nullable
        - `valid_until` string, date, nullable
      - `external_id` string
      - `id` string, required
      - `ins_paid` number
      - `insurance_payments` InsurancePayment[], nullable
        - `adjustment` number, nullable
        - `allowed_amount` number, nullable
        - `coins_amount` number, nullable
        - `company_external_id` string, nullable
        - `date` string, date, nullable
        - `deduct_amount` number, nullable
        - `external_id` string
        - `extra` object, nullable
        - `ins_paid` number, nullable
        - `member_balance` number, nullable
        - `withheld_amount` number, nullable
      - `insurance_policies` VisitInsurancePolicy[], nullable
        - `company_external_id` string, nullable
        - `group_id` string
        - `insurance_name` string
        - `member_id` string
        - `policy_external_id` string, nullable
        - `priority` 'primary' | 'secondary' | 'tertiary' | 'other'
        - `state` InsurancePolicyState
          - `claim_adjustments` Adjustment[]
            - `amount` number, required
            - `group` string, required
            - `reason` string, required
          - `claim_status` string
          - `claim_status_description` string
          - `codes_description` string[]
          - `line_items` ERALineItem[]
            - `adjustments` Adjustment[]
              - …
            - `allowed` number, nullable
            - `billed` number, required
            - `paid` number, required
            - `remark` string, nullable
            - `service_code` string, required
            - `service_date_end` string, date, nullable
            - `service_date_start` string, date, nullable
            - `units` integer, nullable
      - `location` Location
        - `collectly_id` string
        - `id` string, required
        - `name` string
      - `location_id` string, nullable, required
      - `meta` unknown
      - `notes` string[], nullable
      - `patient_name` string, nullable
      - `provider` Provider
        - `collectly_id` string
        - `first_name` string
        - `id` string, required
        - `last_name` string
      - `provider_id` string, nullable, required
      - `pt_adjustment` number
      - `pt_amount` number
      - `pt_bad_debt` number, nullable
      - `pt_balance` number
      - `pt_balance_on_hold` number
      - `pt_paid` number
      - `raw_adjustments` object[], nullable
      - `service_date` string, date, required
      - `visit_pt_adjustment` number
  - `id` integer
  - `ins_paid` number, nullable
  - `modified_at` unknown
  - `patient_id` string
  - `practice_id` string, required
  - `pt_amount` number
  - `pt_balance` number

## Changes

- **2026-11-03** `a45575a6e4b8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/collectly/apis/partners1/changes/practices/:practice_id/patients/:patient_id/statement/post.md)

---

[API](https://skmtc.dev/collectly/apis/partners1.md) - [All operations](https://skmtc.dev/collectly/apis/partners1/llms.txt) - [OpenAPI document](https://skmtc.dev/collectly/apis/partners1/revisions/a45575a6e4b8?raw)
