Retrieve company file info

Returns detailed information about the connected QuickBooks company file, including company address, legal name, preferences, and subscribed services. Note that company information cannot be modified through the API, only through the QuickBooks Desktop user interface.

get/quickbooks-desktop/company

Headers

Conductor-End-User-Idstring required

The ID of the End-User to receive this request.

Example:end_usr_1234567abcdefg

The ID of the End-User to receive this request.

Response

Returns an object with the company file's information.

isSampleCompanyFileboolean required

Indicates whether the connected QuickBooks company file is a "sample file", which is a mock company file used for testing.

companyNamestring nullable required

The name of the QuickBooks user's business associated with this company. This name is used on invoices, checks, and other forms, while legalCompanyName is used on tax forms and pay stubs.

legalCompanyNamestring nullable required

The legal name of this company's business, as specified in QuickBooks. This value is used on tax forms and pay stubs, while companyName is used on invoices, checks, and other forms.

phonestring nullable required

The company's primary telephone number.

faxstring nullable required

The company's fax number.

emailstring nullable required

The company's email address.

websitestring nullable required

The company's public website.

fiscalYearStartMonth'january' | 'february' | 'march' | 'april' | 'may' | 'june' | 'july' | 'august' | 'september' | 'october' | 'november' | 'december' nullable required

The first month of this company's fiscal year, which determines the default date range for financial reports.

incomeTaxYearStartMonth'january' | 'february' | 'march' | 'april' | 'may' | 'june' | 'july' | 'august' | 'september' | 'october' | 'november' | 'december' nullable required

The first month of this company's income tax year, which determines the default date range for financial reports.

companyTypestring nullable required

The company type, which the QuickBooks user selected from a list when creating the company file.

einstring nullable required

The company's Employer Identification Number.

ssnstring nullable required

The company's Social Security Number. The value can be with or without dashes.

NOTE: This field cannot be changed after the company is created.

taxForm'form_1040' | 'form_1065' | 'form_1120' | 'form_1120s' | 'form_990' | 'form_990pf' | 'form_990t' | 'other_or_none' | 'form_t1' | 'form_t2' nullable required

The tax form that the QuickBooks user expects to file for this company's taxes. When a specific tax form is selected (any value other than other_or_none), QuickBooks allows associating each account with a specific tax form line. This association appears in account query responses.

Example response

{
  "companyName": "John Doe's Plumbing",
  "legalCompanyName": "John Doe's Plumbing, LLC",
  "address": {
    "line1": "Conductor Labs Inc.",
    "line2": "540 Market St.",
    "line3": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94110",
    "country": "United States",
    "note": "Conductor HQ"
  },
  "legalAddress": {
    "line1": "Conductor Labs Inc.",
    "line2": "540 Market St.",
    "line3": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94110",
    "country": "United States",
    "note": "Conductor HQ"
  },
  "addressForCustomer": {
    "line1": "Conductor Labs Inc.",
    "line2": "540 Market St.",
    "line3": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94110",
    "country": "United States",
    "note": "Conductor HQ"
  },
  "phone": "+1-555-123-4567",
  "fax": "+1-555-555-1212",
  "email": "company@example.com",
  "website": "https://www.johndoeplumbing.com",
  "fiscalYearStartMonth": "january",
  "incomeTaxYearStartMonth": "january",
  "companyType": "WholesaleDistributionandSales",
  "ein": "123456789",
  "ssn": "123-45-6789",
  "taxForm": "form_1040",
  "subscribedServices": {
    "services": [
      {
        "name": "Intuit Payroll",
        "domain": "payroll.qb",
        "serviceStatus": "active"
      }
    ]
  },
  "accountantCopy": {
    "accountantCopyExists": true,
    "dividingDate": "2024-01-01"
  },
  "customFields": [
    {
      "ownerId": "0",
      "name": "Customer Rating",
      "type": "string_1024_type",
      "value": "Premium"
    }
  ]
}

Changes

Changed in 5 of the 46 revisions of this API.4137107

    • added the new form_t2 enum value to the taxForm/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

    • added the new form_t1 enum value to the taxForm/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

  • 10d4e9ebd1df1245See the full diff
    • response property companyName list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property companyType list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property ein list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property email list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property fax list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property fiscalYearStartMonth list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property incomeTaxYearStartMonth list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property legalCompanyName list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property phone list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property ssn list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property taxForm list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property website list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • added qbd_accountant_copy subschema #2 to the accountantCopy response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_address subschema #2 to the address response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_address subschema #2 to the addressForCustomer response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_address subschema #2 to the legalAddress response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_subscribed_service subschema #2 to the subscribedServices response property anyOf list for the response status 200

      response-property-any-of-added

    • removed the april enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the april enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the august enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the august enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the december enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the december enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the february enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the february enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1040 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1065 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1120 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1120s enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_990 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_990pf enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_990t enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the january enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the january enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the july enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the july enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the june enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the june enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the march enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the march enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the may enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the may enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the november enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the november enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the october enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the october enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the other_or_none enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the september enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the september enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the undefined enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the undefined enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the undefined enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed qbd_accountant_copy subschema #2 from the accountantCopy response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_address subschema #2 from the address response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_address subschema #2 from the addressForCustomer response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_address subschema #2 from the legalAddress response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_subscribed_service subschema #2 from the subscribedServices response property oneOf list for the response status 200

      response-property-one-of-removed

  • 8e0b7df2044d173517See the full diff
    • the response property companyName became nullable for the status 200

      response-property-became-nullable

    • the response property companyType became nullable for the status 200

      response-property-became-nullable

    • the response property ein became nullable for the status 200

      response-property-became-nullable

    • the response property email became nullable for the status 200

      response-property-became-nullable

    • the response property fax became nullable for the status 200

      response-property-became-nullable

    • the response property fiscalYearStartMonth became nullable for the status 200

      response-property-became-nullable

    • the response property incomeTaxYearStartMonth became nullable for the status 200

      response-property-became-nullable

    • the response property legalCompanyName became nullable for the status 200

      response-property-became-nullable

    • the response property phone became nullable for the status 200

      response-property-became-nullable

    • the response property ssn became nullable for the status 200

      response-property-became-nullable

    • the response property taxForm became nullable for the status 200

      response-property-became-nullable

    • the response property website became nullable for the status 200

      response-property-became-nullable

    • added qbd_accountant_copy subschema #2 to the accountantCopy response property oneOf list for the response status 200

      response-property-one-of-added

    • added qbd_address subschema #2 to the address response property oneOf list for the response status 200

      response-property-one-of-added

    • added qbd_address subschema #2 to the addressForCustomer response property oneOf list for the response status 200

      response-property-one-of-added

    • added qbd_address subschema #2 to the legalAddress response property oneOf list for the response status 200

      response-property-one-of-added

    • added qbd_subscribed_service subschema #2 to the subscribedServices response property oneOf list for the response status 200

      response-property-one-of-added

    • added the new april enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new april enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new august enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new august enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new december enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new december enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new february enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new february enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new form_1040 enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new form_1065 enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new form_1120 enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new form_1120s enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new form_990 enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new form_990pf enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new form_990t enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new january enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new january enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new july enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new july enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new june enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new june enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new march enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new march enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new may enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new may enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new november enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new november enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new october enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new october enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new other_or_none enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • added the new september enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new september enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new undefined enum value to the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new undefined enum value to the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-added

    • added the new undefined enum value to the taxForm response property for the response status 200

      response-property-enum-value-added

    • removed qbd_accountant_copy subschema #2 from the accountantCopy response property anyOf list for the response status 200

      response-property-any-of-removed

    • removed qbd_address subschema #2 from the address response property anyOf list for the response status 200

      response-property-any-of-removed

    • removed qbd_address subschema #2 from the addressForCustomer response property anyOf list for the response status 200

      response-property-any-of-removed

    • removed qbd_address subschema #2 from the legalAddress response property anyOf list for the response status 200

      response-property-any-of-removed

    • removed qbd_subscribed_service subschema #2 from the subscribedServices response property anyOf list for the response status 200

      response-property-any-of-removed

    • response property companyName list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property companyType list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property ein list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property email list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property fax list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property fiscalYearStartMonth list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property incomeTaxYearStartMonth list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property legalCompanyName list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property phone list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property ssn list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property taxForm list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • response property website list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

  • 5f832f6956751245See the full diff
    • response property companyName list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property companyType list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property ein list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property email list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property fax list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property fiscalYearStartMonth list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property incomeTaxYearStartMonth list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property legalCompanyName list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property phone list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property ssn list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property taxForm list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property website list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • added qbd_accountant_copy subschema #2 to the accountantCopy response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_address subschema #2 to the address response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_address subschema #2 to the addressForCustomer response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_address subschema #2 to the legalAddress response property anyOf list for the response status 200

      response-property-any-of-added

    • added qbd_subscribed_service subschema #2 to the subscribedServices response property anyOf list for the response status 200

      response-property-any-of-added

    • removed the april enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the april enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the august enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the august enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the december enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the december enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the february enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the february enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1040 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1065 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1120 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_1120s enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_990 enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_990pf enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the form_990t enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the january enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the january enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the july enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the july enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the june enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the june enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the march enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the march enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the may enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the may enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the november enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the november enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the october enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the october enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the other_or_none enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed the september enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the september enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the undefined enum value from the fiscalYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the undefined enum value from the incomeTaxYearStartMonth response property for the response status 200

      response-property-enum-value-removed

    • removed the undefined enum value from the taxForm response property for the response status 200

      response-property-enum-value-removed

    • removed qbd_accountant_copy subschema #2 from the accountantCopy response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_address subschema #2 from the address response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_address subschema #2 from the addressForCustomer response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_address subschema #2 from the legalAddress response property oneOf list for the response status 200

      response-property-one-of-removed

    • removed qbd_subscribed_service subschema #2 from the subscribedServices response property oneOf list for the response status 200

      response-property-one-of-removed