COconductor-is

Retrieve company file info

Changed on

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

Request

Headers

Conductor-End-User-Idstring required

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

Example:end_usr_1234567abcdefg

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

  • 272ef19cffe4Revision changes
    • warning

      added the new form_t2 enum value to the / response property for the response status

  • fa0d99aff54eRevision changes
    • warning

      added the new form_t1 enum value to the / response property for the response status