--- title: "Update Company" method: PUT path: "/v1/companies/company/{id}" tags: ["API / Company", "Use case / Master data sync"] --- # Update Company `PUT /v1/companies/company/{id}` ## Request - Base URL: `https://api.qargo.com` - URL: `https://api.qargo.com/v1/companies/company/{id}` - Auth: OAuth 2 (client credentials, token URL `/v1/auth/token`) ## Path parameters - `id` string, uuid, required ## Request body - CompanyInput - `is_customer` boolean: Indicate that this company is a customer - `is_buyer_or_seller` boolean, nullable: Indicates that this company is a buyer or seller of a consignment - `name` string, nullable: Name of the company. - `code` string, nullable: External reference to this company record - `currency` string, required: Currency of the company (ISO 4217, 3 letter code) - `custom_fields` object, nullable: Custom fields of the company - `credit_policy` CreditPolicyInput - `limit` number, nullable: The limit for total amount that has been invoiced but not paid. - `default_invoice_customer_id` string, uuid, nullable: ID of the default invoice customer (bill-to) for this company. When set, charges for this customer are billed to the referenced company instead. - `is_subcontractor` boolean: Indicate that this company is a subcontractor (supplier) - `archived_customer` boolean, nullable: Set to `true` to archive the customer role of this company, or `false` to reactivate it. Has no effect if `is_customer` is `false`. - `archived_subcontractor` boolean, nullable: Set to `true` to archive the subcontractor role of this company, or `false` to reactivate it. Has no effect if `is_subcontractor` is `false`. - `legal_name` string, nullable: Legal name of the company. - `locale` string, nullable: Locale of the company. Format: ISO 639-1 language code, optionally followed by a dash and ISO 3166-1 alpha-2 country code. - `vat_number` string, nullable: VAT number of the company. - `reference_numbers` CompanyReferenceNumbers - `eori_number` string, nullable: Economic Operator Registration and Identification - `duns_number` string, nullable: D-U-N-S Number - `scac_code` string, nullable: Standard Carrier Alpha Code - `company_registration_number` string, nullable: Company Registration Number - `tss_registration_number` string, nullable: TSS registration number - `note` string, nullable: Additional notes about the company - `tax_type` 'VAT' | 'REVERSE_CHARGE' | 'UK_REVERSE_CHARGE' | 'TRANSIT' | 'NO_VAT' | 'CO_CONTRACTING' | 'OTHER' - `bank_accounts` BankAccount[], nullable: List of associated bank accounts. - `bic_code` string, nullable - `iban_code` string, nullable - `accounting_code` string, nullable: Code linked to the accounting system - `billing_location` BillingLocation - `code` string, nullable: Code of the location - `display_name` string, nullable: Human-readable label for a location in operational views. - `external_id` string, nullable: Identifier from an external (master data) system. - `address` string, nullable: First address line of the location - `address_second_line` string, nullable: Second address line of the location - `city` string, nullable: City of the location - `state` string, nullable: State of the location - `country` string, nullable: Country code (ISO 3166-1 alpha-2) of the location - `postal_code` string, nullable: Postal code of the location - `name` string, nullable: Name of the location - `payment_term` BasePaymentTerm - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required - `contacts` CompanyContactInput[], nullable: List of contacts associated with the company - `id` string, uuid, nullable: Unique identifier of the contact. When creating a new contact, this field should be omitted or set to null. This field only needs to be provided when updating an existing contact of the company - `is_archived` boolean: Indicates whether a contact should be archived. Set to true to archive the contact. - `roles` ContactType[]: List of roles associated with the contact. - `name` string, nullable: Name of the contact person associated with the company. - `note` string, nullable: Additional notes about the contact person. - `email` string, nullable: Email address of the contact person. - `phone_number` string, nullable: Phone number of the contact person. Expected format is E.164 (e.g., +32485123456). - `sales` SalesCompanyFieldsInput - `payment_term` BasePaymentTerm - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required - `billing_entities` CompanyBillingEntity[], nullable: List of billing entities associated with the company - `id` string, uuid, nullable: Unique identifier of the billing entity associated with the company. - `code` string, nullable: Code of the billing entity associated with the company. - `accounting_code` string, nullable: Accounting code linked to the billing entity for the company. - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED' - `purchase` PurchaseCompanyFieldsInput - `payment_term` BasePaymentTerm - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required - `billing_entities` CompanyBillingEntity[], nullable: List of billing entities associated with the company - `id` string, uuid, nullable: Unique identifier of the billing entity associated with the company. - `code` string, nullable: Code of the billing entity associated with the company. - `accounting_code` string, nullable: Accounting code linked to the billing entity for the company. - `status` 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED' - `credit_limit_total` number, nullable: The limit for total amount that has been invoiced but not paid. **Deprecated**: use `credit_policy.limit` instead. - `is_blocked` boolean, nullable: Set to true to disallow new order creation for companies representing companies. **Note**: Deprecated in favor of `status` under the `sales` and `purchase` fields.an update of `status` will always prevail over `is_blocked` update. - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED' ## Response `200` Successful Response - CompanyDetailOutput - `id` string, uuid, required: The unique identifier of the company. - `code` string, nullable: External reference to this company record - `currency` string, required: Currency of the company (ISO 4217, 3 letter code) - `custom_fields` object, nullable: Custom fields of the company - `is_customer` boolean: Indicate that this company is a customer - `is_subcontractor` boolean: Indicate that this company is a subcontractor (supplier) - `is_buyer_or_seller` boolean, nullable: Indicates that this company is a buyer or seller of a consignment - `name` string, required: Name of the company. - `legal_name` string, nullable: Legal name of the company. - `vat_number` string, nullable: VAT number of the company. - `note` string, nullable: Additional notes about the company - `tax_type` 'VAT' | 'REVERSE_CHARGE' | 'UK_REVERSE_CHARGE' | 'TRANSIT' | 'NO_VAT' | 'CO_CONTRACTING' | 'OTHER' - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED' - `accounting_code` string, nullable: Default customer accounting code linked to the accounting system. Please use the accounting codes on the billing entities, as these are split per billing entity and between sales/purchase sides. - `billing_location` LocationOutput - `code` string, nullable: Technical code for integrations/mapping logic; should be treated as stable once set. - `display_name` string, nullable: Human-readable label for a location in operational views. - `external_id` string, nullable: Identifier from an external (master data) system. - `address` string, nullable: First address line of the location - `address_second_line` string, nullable: Second address line of the location - `city` string, nullable: City of the location - `state` string, nullable: State of the location - `country` string, nullable: Country code (ISO 3166-1 alpha-2) of the location - `postal_code` string, nullable: Postal code of the location - `name` string, nullable: Name of the location - `id` string, uuid, nullable: Unique identifier of the location - `latitude` number, nullable: Latitude of the location - `longitude` number, nullable: Longitude of the location - `payment_term` BasePaymentTerm - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required - `locale` string, required: Locale of the company. Format: ISO 639-1 language code, optionally followed by a dash and ISO 3166-1 alpha-2 country code. - `archived_customer` boolean, required: Indicate that this company is archived as a customer - `archived_subcontractor` boolean, required: Indicate that this company is archived as a subcontractor - `archived_buyer_or_seller` boolean, required: Indicates that this company is archived as buyer/seller of a consignment - `credit_policy` CreditPolicyOutput - `limit` number, nullable: The limit for total amount that has been invoiced but not paid. - `default_invoice_customer` ApiAccountingModelsCompanyCompanyReferenceOutput - `id` string, uuid, required: The unique identifier of the company. - `name` string, required: Name of the company. - `code` string, nullable: External reference to this company record - `reference_numbers` CompanyReferenceNumbers - `eori_number` string, nullable: Economic Operator Registration and Identification - `duns_number` string, nullable: D-U-N-S Number - `scac_code` string, nullable: Standard Carrier Alpha Code - `company_registration_number` string, nullable: Company Registration Number - `tss_registration_number` string, nullable: TSS registration number - `bank_accounts` BankAccount[]: List of associated bank accounts. - `bic_code` string, nullable - `iban_code` string, nullable - `contacts` CompanyContactOutput[], nullable: List of contacts associated with the company - `id` string, uuid, nullable: Unique identifier of the contact - `roles` ContactType[]: List of roles associated with the contact. - `name` string, nullable: Name of the contact person associated with the company. - `note` string, nullable: Additional notes about the contact person. - `email` string, nullable: Email address of the contact person. - `phone_number` string, nullable: Phone number of the contact person. - `sales` SalesCompanyFieldsOutput - `payment_term` BasePaymentTerm - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required - `billing_entities` CompanyBillingEntity[], nullable: List of billing entities associated with the company - `id` string, uuid, nullable: Unique identifier of the billing entity associated with the company. - `code` string, nullable: Code of the billing entity associated with the company. - `accounting_code` string, nullable: Accounting code linked to the billing entity for the company. - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED' - `purchase` PurchaseCompanyFieldsOutput - `payment_term` BasePaymentTerm - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required - `billing_entities` CompanyBillingEntity[], nullable: List of billing entities associated with the company - `id` string, uuid, nullable: Unique identifier of the billing entity associated with the company. - `code` string, nullable: Code of the billing entity associated with the company. - `accounting_code` string, nullable: Accounting code linked to the billing entity for the company. - `status` 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED' - `timestamp_updated` string, date-time, required: The date and time when the company was last updated. - `is_blocked` boolean: Set to true to disallow new order creation for companies representing companies. **Note**: Deprecated in favor of `status`. - `credit_limit_total` number, nullable: The limit for total amount that has been invoiced but not paid. **Deprecated**: use `credit_policy.limit` instead. ## Other responses - `400`: Bad Request — invalid input or malformed request - `401`: Unauthorized — missing or invalid authentication credentials - `403`: Forbidden — insufficient permissions for this operation - `422`: Validation Error - `429`: Too Many Requests — rate limit exceeded. See the `Retry-After` header - `500`: Internal Server Error - `503`: Service Unavailable — temporarily unable to handle the request ## Changes - **2026-09-28** `cf0a203f13f4`: 1 warning, 1 info - added the new `UK_REVERSE_CHARGE` enum value to the `tax_type/anyOf[subschema #1: TaxTypeEnum]/` response property for the response status `200` - added the new `UK_REVERSE_CHARGE` enum value to the request property `tax_type/anyOf[subschema #1: TaxTypeEnum]/` - **2026-09-25** `6abdfcd1a541`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status [Operation history](https://skmtc.dev/qargo/apis/qargo-tms-api/changes/v1/companies/company/:id/put.md) --- [API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qargo/apis/qargo-tms-api/revisions/46db2c329351?raw)