---
title: "Partial Update Contract Customer"
method: PATCH
path: "/rr/api/v1/customers/{id}"
tags: ["Revenue Recognition"]
---

# Partial Update Contract Customer

`PATCH /rr/api/v1/customers/{id}`

## Path parameters

- `id` integer, required

## Request body

- PatchedContractCustomer
  - `id` integer
  - `contacts` VendorContact[]
    - `id` integer, required
    - `name` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `email` string, email, nullable
    - `phone_number` string, nullable
    - `mobile_number` string, nullable
    - `last_modified_at` string, date-time, required
    - `is_deleted` boolean, required
    - `deleted_at` string, date-time, nullable, required
  - `parent_name` string
  - `stripe_connection_name` string, nullable
  - `stripe_connection_entity` integer, nullable
  - `stripe_connection_portal_url` string, nullable
  - `stripe_connection_portal_enabled` boolean, nullable
  - `stripe_connection_invoicing_enabled` boolean, nullable
  - `vendor_custom_field_1_name` string
  - `payment_term_name_display` string
  - `last_modified_at` string, date-time
  - `is_deleted` boolean
  - `deleted_at` string, date-time, nullable
  - `active_contracts` integer
  - `completed_contracts` integer
  - `pending_contracts` integer
  - `total_contracts` integer
  - `total_revenue` number, double
  - `total_deferred_revenue` number, double
  - `total_mrr` number, double
  - `total_billed` number, double
  - `total_unbilled` number, double
  - `total_paid` number, double
  - `total_outstanding` number, double
  - `total_credit_memos` number, double
  - `credit_memo_applied` number, double
  - `credit_memo_available` number, double
  - `currency` string
  - `search_vector` string, nullable
  - `search_text` string, nullable
  - `campfire_id` string, nullable
  - `vendor_type` union
    - 'vendor' | 'customer' | 'employee' — * `vendor` - Vendor * `customer` - Customer * `employee` - Employee
    - ''
    - unknown
  - `name` string, nullable
  - `dba` string, nullable
  - `company_name` string, nullable
  - `website` string, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `phone_number` string, nullable
  - `mobile_number` string, nullable
  - `address_street_1` string, nullable
  - `address_street_2` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zip_code` string, nullable
  - `country` string, nullable
  - `billing_address_street_1` string, nullable
  - `billing_address_street_2` string, nullable
  - `billing_city` string, nullable
  - `billing_state` string, nullable
  - `billing_zip_code` string, nullable
  - `billing_country` string, nullable
  - `shipping_addressee` string, nullable
  - `billing_addressee` string, nullable
  - `notes` string, nullable
  - `business_id_ssn` string, nullable
  - `is_1099` boolean
  - `vat_number` string, nullable
  - `business_type` string, nullable — Business type classification (e.g., Korean NTS 업태)
  - `business_category` string, nullable — Business category classification (e.g., Korean NTS 종목)
  - `entity_use_code` string, nullable — Avalara entity/use code for tax exemptions (e.g., A - Federal Government, B - State/Local Govt)
  - `withholding_tax_id` string, nullable — Vendor's tax-authority ID for withholding (PAN for India, TZ for Israel). Dedicated field since these have format/checksum rules distinct from business_id_ssn.
  - `ita_deduction_type_code` union — Israel tax compliance: ITA nature-of-payment deduction type code for Form 856. * `1` - Services * `2` - Rent * `3` - Commissions * `4` - Interest * `5` - Dividends
    - '1' | '2' | '3' | '4' | '5' — * `1` - Services * `2` - Rent * `3` - Commissions * `4` - Interest * `5` - Dividends
    - ''
    - unknown
  - `ita_vendor_entity_code` union — Israel tax compliance: vendor residency classification for Form 856. * `0` - Israeli company * `2` - PA resident * `3` - Foreign individual * `5` - Foreign company
    - '0' | '2' | '3' | '5' — * `0` - Israeli company * `2` - PA resident * `3` - Foreign individual * `5` - Foreign company
    - ''
    - unknown
  - `ita_vendor_entity_type` union — Israel tax compliance: vendor legal-form classification for Form 856. * `1` - Individual * `2` - Company * `3` - Osek
    - '1' | '2' | '3' — * `1` - Individual * `2` - Company * `3` - Osek
    - ''
    - unknown
  - `stripe_customer_id` string, nullable
  - `use_stripe_auto_bill` boolean, nullable
  - `bill_vendor_id` string, nullable
  - `external_id` string, nullable
  - `source` union
    - 'BILL' | 'BREX' | 'HUBSPOT' | 'MANUAL' | 'PAYROLL' | 'SALESFORCE' — * `BILL` - Bill * `BREX` - Brex * `HUBSPOT` - Hubspot * `MANUAL` - Manual * `PAYROLL` - Payroll * `SALESFORCE` - Salesforce
    - ''
    - unknown
  - `invoice_message` string, nullable
  - `abbreviation` string, nullable
  - `created_at` string, date-time
  - `status` 'ACTIVE' | 'INACTIVE' — * `ACTIVE` - Active * `INACTIVE` - Inactive
  - `anrok_customer_id` string, nullable
  - `avalara_customer_id` string, nullable
  - `terms` union
    - 'custom' | 'net_5' | 'net_7' | 'net_10' | 'net_15' | 'net_20' | 'net_30' | 'net_40' | 'net_45' | 'net_60' | 'net_90' | 'net_105' | 'net_120' | 'due_on_receipt' — * `custom` - Custom * `net_5` - Net 5 * `net_7` - Net 7 * `net_10` - Net 10 * `net_15` - Net 15 * `net_20` - Net 20 * `net_30` - Net 30 * `net_40` - Net 40 * `net_45` - Net 45 * `net_60` - Net 60 * `net_90` - Net 90 * `net_105` - Net 105 * `net_120` - Net 120 * `due_on_receipt` - Due on Receipt
    - ''
    - unknown
  - `invoice_labels` unknown
  - `invoice_language` string, nullable
  - `lineage_array` string[], nullable — Pre-computed lineage array from root to this vendor
  - `customer` integer
  - `parent` integer, nullable
  - `stripe_connection` integer, nullable
  - `default_expense_category` integer, nullable
  - `vendor_custom_field_1` integer, nullable
  - `payment_term` integer, nullable — Payment term for this vendor

## Response `200`

- ContractCustomer
  - `id` integer, required
  - `contacts` VendorContact[]
    - `id` integer, required
    - `name` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `email` string, email, nullable
    - `phone_number` string, nullable
    - `mobile_number` string, nullable
    - `last_modified_at` string, date-time, required
    - `is_deleted` boolean, required
    - `deleted_at` string, date-time, nullable, required
  - `parent_name` string, required
  - `stripe_connection_name` string, nullable, required
  - `stripe_connection_entity` integer, nullable, required
  - `stripe_connection_portal_url` string, nullable, required
  - `stripe_connection_portal_enabled` boolean, nullable, required
  - `stripe_connection_invoicing_enabled` boolean, nullable, required
  - `vendor_custom_field_1_name` string, required
  - `payment_term_name_display` string, required
  - `last_modified_at` string, date-time, required
  - `is_deleted` boolean, required
  - `deleted_at` string, date-time, nullable, required
  - `active_contracts` integer, required
  - `completed_contracts` integer, required
  - `pending_contracts` integer, required
  - `total_contracts` integer, required
  - `total_revenue` number, double, required
  - `total_deferred_revenue` number, double, required
  - `total_mrr` number, double, required
  - `total_billed` number, double, required
  - `total_unbilled` number, double, required
  - `total_paid` number, double, required
  - `total_outstanding` number, double, required
  - `total_credit_memos` number, double, required
  - `credit_memo_applied` number, double, required
  - `credit_memo_available` number, double, required
  - `currency` string, required
  - `search_vector` string, nullable, required
  - `search_text` string, nullable, required
  - `campfire_id` string, nullable, required
  - `vendor_type` union
    - 'vendor' | 'customer' | 'employee' — * `vendor` - Vendor * `customer` - Customer * `employee` - Employee
    - ''
    - unknown
  - `name` string, nullable, required
  - `dba` string, nullable
  - `company_name` string, nullable
  - `website` string, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `phone_number` string, nullable
  - `mobile_number` string, nullable
  - `address_street_1` string, nullable
  - `address_street_2` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zip_code` string, nullable
  - `country` string, nullable
  - `billing_address_street_1` string, nullable
  - `billing_address_street_2` string, nullable
  - `billing_city` string, nullable
  - `billing_state` string, nullable
  - `billing_zip_code` string, nullable
  - `billing_country` string, nullable
  - `shipping_addressee` string, nullable
  - `billing_addressee` string, nullable
  - `notes` string, nullable
  - `business_id_ssn` string, nullable
  - `is_1099` boolean
  - `vat_number` string, nullable
  - `business_type` string, nullable — Business type classification (e.g., Korean NTS 업태)
  - `business_category` string, nullable — Business category classification (e.g., Korean NTS 종목)
  - `entity_use_code` string, nullable — Avalara entity/use code for tax exemptions (e.g., A - Federal Government, B - State/Local Govt)
  - `withholding_tax_id` string, nullable — Vendor's tax-authority ID for withholding (PAN for India, TZ for Israel). Dedicated field since these have format/checksum rules distinct from business_id_ssn.
  - `ita_deduction_type_code` union — Israel tax compliance: ITA nature-of-payment deduction type code for Form 856. * `1` - Services * `2` - Rent * `3` - Commissions * `4` - Interest * `5` - Dividends
    - '1' | '2' | '3' | '4' | '5' — * `1` - Services * `2` - Rent * `3` - Commissions * `4` - Interest * `5` - Dividends
    - ''
    - unknown
  - `ita_vendor_entity_code` union — Israel tax compliance: vendor residency classification for Form 856. * `0` - Israeli company * `2` - PA resident * `3` - Foreign individual * `5` - Foreign company
    - '0' | '2' | '3' | '5' — * `0` - Israeli company * `2` - PA resident * `3` - Foreign individual * `5` - Foreign company
    - ''
    - unknown
  - `ita_vendor_entity_type` union — Israel tax compliance: vendor legal-form classification for Form 856. * `1` - Individual * `2` - Company * `3` - Osek
    - '1' | '2' | '3' — * `1` - Individual * `2` - Company * `3` - Osek
    - ''
    - unknown
  - `stripe_customer_id` string, nullable
  - `use_stripe_auto_bill` boolean, nullable
  - `bill_vendor_id` string, nullable
  - `external_id` string, nullable
  - `source` union
    - 'BILL' | 'BREX' | 'HUBSPOT' | 'MANUAL' | 'PAYROLL' | 'SALESFORCE' — * `BILL` - Bill * `BREX` - Brex * `HUBSPOT` - Hubspot * `MANUAL` - Manual * `PAYROLL` - Payroll * `SALESFORCE` - Salesforce
    - ''
    - unknown
  - `invoice_message` string, nullable
  - `abbreviation` string, nullable
  - `created_at` string, date-time, required
  - `status` 'ACTIVE' | 'INACTIVE' — * `ACTIVE` - Active * `INACTIVE` - Inactive
  - `anrok_customer_id` string, nullable
  - `avalara_customer_id` string, nullable
  - `terms` union
    - 'custom' | 'net_5' | 'net_7' | 'net_10' | 'net_15' | 'net_20' | 'net_30' | 'net_40' | 'net_45' | 'net_60' | 'net_90' | 'net_105' | 'net_120' | 'due_on_receipt' — * `custom` - Custom * `net_5` - Net 5 * `net_7` - Net 7 * `net_10` - Net 10 * `net_15` - Net 15 * `net_20` - Net 20 * `net_30` - Net 30 * `net_40` - Net 40 * `net_45` - Net 45 * `net_60` - Net 60 * `net_90` - Net 90 * `net_105` - Net 105 * `net_120` - Net 120 * `due_on_receipt` - Due on Receipt
    - ''
    - unknown
  - `invoice_labels` unknown
  - `invoice_language` string, nullable
  - `lineage_array` string[], nullable — Pre-computed lineage array from root to this vendor
  - `customer` integer, required
  - `parent` integer, nullable
  - `stripe_connection` integer, nullable, required
  - `default_expense_category` integer, nullable
  - `vendor_custom_field_1` integer, nullable
  - `payment_term` integer, nullable — Payment term for this vendor

---

[API](https://skmtc.net/campfire/apis/campfire-developer-apis.md) · [All operations](https://skmtc.net/campfire/apis/campfire-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/campfire/campfire-developer-apis/versions/6945ebc3180e/schema)
