---
title: "Update carrier factor"
method: PATCH
path: "/carrier-factors/{id}"
tags: ["Carrier Factors"]
---

# Update carrier factor

`PATCH /carrier-factors/{id}`

Partially update a carrier factor. Only provided fields will be updated.

- **Omitted fields**: Not modified (current value preserved)
- **Provided fields**: Updated to the new value
- **Null values**: Clear the field (set to null) where applicable

## Path parameters

- `id` string, required

## Request body

- CarrierFactorPatch — Partial carrier factor update. All fields are optional. - **Omitted fields**: Not modified (current value preserved) - **Provided fields**: Updated to the new value - **Null values**: Clear the field (set to null) where applicable
  - `companyName` string — Factoring company legal name
  - `key` string, nullable — Client-defined reference identifier
  - `email` string, email, nullable — Primary email address
  - `phoneNumber` string, nullable — Primary phone number
  - `phoneExtension` string, nullable — Primary phone extension
  - `fax` string, nullable — Fax number
  - `addressLine1` string, nullable — Primary street address
  - `addressLine2` string, nullable — Secondary address line
  - `city` string, nullable — City name
  - `state` string, nullable — State or province
  - `country` string, nullable — Country code or name
  - `zipCode` string, nullable — Postal/ZIP code
  - `bankName` string, nullable — Bank name
  - `bankAddress` string, nullable — Bank address
  - `accountName` string, nullable — Bank account holder name
  - `accountNumber` string, nullable — Bank account number
  - `abaAch` string, nullable — ABA/ACH routing number
  - `wire` string, nullable — Wire transfer routing number
  - `swiftCode` string, nullable — SWIFT/BIC code for international transfers
  - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
  - `eftTransit` string, nullable — EFT transit number (Canadian banking)
  - `clabe` string, nullable — CLABE number (Mexican banking)
  - `currency` string, nullable — Preferred currency code (ISO 4217)
  - `paymentTermId` string, uuid, nullable — Payment term ID

## Response `200`

Carrier factor updated successfully

- CarrierFactor
  - `id` string, uuid, required — Unique carrier factor identifier
  - `companyName` string, required — Factoring company legal name
  - `key` string, nullable — Client-defined reference identifier
  - `email` string, email, nullable — Primary email address
  - `phoneNumber` string, nullable — Primary phone number
  - `phoneExtension` string, nullable — Primary phone extension
  - `fax` string, nullable — Fax number
  - `addressLine1` string, nullable — Primary street address
  - `addressLine2` string, nullable — Secondary address line (suite, floor, etc.)
  - `city` string, nullable — City name
  - `state` string, nullable — State or province
  - `country` string, nullable — Country code or name
  - `zipCode` string, nullable — Postal/ZIP code
  - `bankName` string, nullable — Bank name
  - `bankAddress` string, nullable — Bank address
  - `accountName` string, nullable — Bank account holder name
  - `accountNumber` string, nullable — Bank account number
  - `abaAch` string, nullable — ABA/ACH routing number for electronic transfers
  - `wire` string, nullable — Wire transfer routing number
  - `swiftCode` string, nullable — SWIFT/BIC code for international transfers
  - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
  - `eftTransit` string, nullable — EFT transit number (Canadian banking)
  - `clabe` string, nullable — CLABE number (Mexican banking identifier)
  - `currency` string, nullable — Preferred currency code (ISO 4217)
  - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
    - `id` string, uuid, required — Payment term UUID
    - `key` string, nullable — Client-defined reference ID if set
    - `name` string, required — Payment term name
    - `description` string, nullable — Payment term description or notes
    - `days` integer, nullable — Number of days until payment is due
    - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
    - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
    - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
    - `createdAt` string, date-time, required — When the payment term was created
    - `updatedAt` string, date-time, required — When the payment term was last updated
    - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
  - `createdAt` string, date-time, required — When the carrier factor was created
  - `updatedAt` string, date-time, required — When the carrier factor was last updated
  - `deletedAt` string, date-time, nullable — When the carrier factor was soft deleted (null if active)

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid or missing access token
- `404` — Resource not found
- `409` — Conflict - resource already exists or constraint violation
- `500` — Internal server error

---

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