---
title: "Edit Company"
method: PATCH
path: "/companies/{id}"
tags: ["Companies"]
---

# Edit Company

`PATCH /companies/{id}`

## Path parameters

- `id` string, uuid, required

## Request body

- CompanyInput
  - `account_id` string, required — Account id to associate the company with
  - `business_structure` object, required
    - `id` string, required — Business structure id
  - `domicile` JurisdictionInput, required — A jurisdiction reference for use in request bodies. Only the id is required; use the /jurisdictions endpoint to look up valid IDs.
    - `id` string, uuid, required — ID of the jurisdiction
  - `principal_address` AddressInput, required
    - `address_line_1` string, required — First line of the address
    - `locality` string, required — City or locality
    - `administrative_area` JurisdictionInput, required — A jurisdiction reference for use in request bodies. Only the id is required; use the /jurisdictions endpoint to look up valid IDs.
      - `id` string, uuid, required — ID of the jurisdiction
    - `postal_code` string, required — Postal code
    - `country` JurisdictionInput, required — A jurisdiction reference for use in request bodies. Only the id is required; use the /jurisdictions endpoint to look up valid IDs.
      - `id` string, uuid, required — ID of the jurisdiction
  - `mailing_address` AddressInput, required
    - `address_line_1` string, required — First line of the address
    - `locality` string, required — City or locality
    - `administrative_area` JurisdictionInput, required — A jurisdiction reference for use in request bodies. Only the id is required; use the /jurisdictions endpoint to look up valid IDs.
      - `id` string, uuid, required — ID of the jurisdiction
    - `postal_code` string, required — Postal code
    - `country` JurisdictionInput, required — A jurisdiction reference for use in request bodies. Only the id is required; use the /jurisdictions endpoint to look up valid IDs.
      - `id` string, uuid, required — ID of the jurisdiction
  - `legal_name` string, required — Legal name of the company
  - `formation_date` string, date — Company formation date (YYYY-MM-DD)
  - `fiscal_year_end` string — Fiscal year end in MM/DD format
  - `email` string — Company email address
  - `phone` string — Company phone number
  - `toll_free_phone` string — Company toll-free phone number
  - `fax` string — Company fax number
  - `no_fax` boolean — Whether the company has no fax number
  - `website` string — Company website URL
  - `no_website` boolean — Whether the company has no website
  - `mission` string — Company mission statement
  - `purpose_statement` string — Company purpose statement
  - `primary_product_or_service` string — Primary product or service of the company
  - `ein` string — Employer Identification Number
  - `tax_classification` object
    - `id` string, required — IRS tax classification id (UUID)
  - `accounting_method` object
    - `id` string, required — Accounting method id (UUID)
  - `signers` object[] — Array of user objects representing preferred signers. Each item must contain an id field with a valid user UUID.
    - `id` string, uuid, required — UUID of the user to set as a signer

## Response `200`

Updated

- object
  - `data` Company
    - `id` string, required — id of the company
    - `legal_name` string, required — The company’s exact legal name, including punctuation. We use this data for harvesting data from state agencies, so accuracy ensures the right match.
    - `formation_date` string, date, nullable — Company formation date (YYYY-MM-DD)
    - `fiscal_year_end` string, nullable — Fiscal year end in MM/DD format, or null
    - `phone` string, nullable — Company phone number
    - `toll_free_phone` string, nullable — Company toll-free phone number
    - `email` string, nullable — Company email address
    - `fax` string, nullable — Company fax number
    - `no_fax` boolean — Whether the company has no fax number
    - `website` string, nullable — Company website URL
    - `no_website` boolean — Whether the company has no website
    - `mission` string, nullable — Company mission statement
    - `purpose_statement` string, nullable — Company purpose statement
    - `primary_product_or_service` string, nullable — Primary product or service of the company
    - `ein` string, nullable — Employer Identification Number
    - `domicile` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
      - `id` string, uuid, required — ID of the jurisdiction
      - `name` string, required — Name of the jurisdiction
    - `business_structure` BusinessStructure
      - `id` string, required — id of the business structure
      - `name` string, required — Name of the business structure
    - `principal_address` Address
      - `address_line_1` string, required — First line of the address
      - `address_line_2` string, nullable — Second line of the address (optional)
      - `locality` string, required — City or locality
      - `postal_code` string, required — Postal code
      - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
        - `id` string, uuid, required — ID of the jurisdiction
        - `name` string, required — Name of the jurisdiction
      - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
        - `id` string, uuid, required — ID of the jurisdiction
        - `name` string, required — Name of the jurisdiction
    - `mailing_address` Address
      - `address_line_1` string, required — First line of the address
      - `address_line_2` string, nullable — Second line of the address (optional)
      - `locality` string, required — City or locality
      - `postal_code` string, required — Postal code
      - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
        - `id` string, uuid, required — ID of the jurisdiction
        - `name` string, required — Name of the jurisdiction
      - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
        - `id` string, uuid, required — ID of the jurisdiction
        - `name` string, required — Name of the jurisdiction
    - `tax_classification` IrsTaxClassification
      - `id` string, required — UUID of the IRS tax classification
      - `name` string, required — Name of the tax classification
    - `accounting_method` AccountingMethod
      - `id` string, required — UUID of the accounting method
      - `name` string, required — Name of the accounting method
    - `signers` User[] — Preferred signers for this company
      - `id` string, uuid — UUID of the user
      - `first_name` string — First name of the user
      - `middle_name` string, nullable — Middle name of the user
      - `last_name` string — Last name of the user
      - `full_name` string — Full name of the user
      - `email` string — Email of the user

## Other responses

- `400` — Invalid parameter format
- `401` — Unauthenticated
- `403` — Forbidden - User does not have access

---

[API](https://skmtc.net/harborcompliance/apis/harbor-compliance-api.md) · [All operations](https://skmtc.net/harborcompliance/apis/harbor-compliance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harborcompliance/harbor-compliance-api/revisions/f9302ec2ef8a/schema)