--- title: "Retrieve company file info" method: GET path: "/quickbooks-desktop/company" --- # Retrieve company file info `GET /quickbooks-desktop/company` 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. ## Headers - `Conductor-End-User-Id` string, required — The ID of the End-User to receive this request. ## Response `200` Returns an object with the company file's information. - QbdCompany - `isSampleCompanyFile` boolean, required — Indicates whether the connected QuickBooks company file is a "sample file", which is a mock company file used for testing. - `companyName` string, 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. - `legalCompanyName` string, 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. - `address` QbdAddress, required - `line1` string, nullable, required — The first line of the address (e.g., street, PO Box, or company name). - `line2` string, nullable, required — The second line of the address, if needed (e.g., apartment, suite, unit, or building). - `line3` string, nullable, required — The third line of the address, if needed. - `line4` string, nullable, required — The fourth line of the address, if needed. - `line5` string, nullable, required — The fifth line of the address, if needed. - `city` string, nullable, required — The city, district, suburb, town, or village name of the address. - `state` string, nullable, required — The state, county, province, or region name of the address. - `postalCode` string, nullable, required — The postal code or ZIP code of the address. - `country` string, nullable, required — The country name of the address. - `note` string, nullable, required — A note written at the bottom of the address in the form in which it appears, such as the invoice form. - `legalAddress` QbdAddress, required - `line1` string, nullable, required — The first line of the address (e.g., street, PO Box, or company name). - `line2` string, nullable, required — The second line of the address, if needed (e.g., apartment, suite, unit, or building). - `line3` string, nullable, required — The third line of the address, if needed. - `line4` string, nullable, required — The fourth line of the address, if needed. - `line5` string, nullable, required — The fifth line of the address, if needed. - `city` string, nullable, required — The city, district, suburb, town, or village name of the address. - `state` string, nullable, required — The state, county, province, or region name of the address. - `postalCode` string, nullable, required — The postal code or ZIP code of the address. - `country` string, nullable, required — The country name of the address. - `note` string, nullable, required — A note written at the bottom of the address in the form in which it appears, such as the invoice form. - `addressForCustomer` QbdAddress, required - `line1` string, nullable, required — The first line of the address (e.g., street, PO Box, or company name). - `line2` string, nullable, required — The second line of the address, if needed (e.g., apartment, suite, unit, or building). - `line3` string, nullable, required — The third line of the address, if needed. - `line4` string, nullable, required — The fourth line of the address, if needed. - `line5` string, nullable, required — The fifth line of the address, if needed. - `city` string, nullable, required — The city, district, suburb, town, or village name of the address. - `state` string, nullable, required — The state, county, province, or region name of the address. - `postalCode` string, nullable, required — The postal code or ZIP code of the address. - `country` string, nullable, required — The country name of the address. - `note` string, nullable, required — A note written at the bottom of the address in the form in which it appears, such as the invoice form. - `phone` string, nullable, required — The company's primary telephone number. - `fax` string, nullable, required — The company's fax number. - `email` string, nullable, required — The company's email address. - `website` string, 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. - `companyType` string, nullable, required — The company type, which the QuickBooks user selected from a list when creating the company file. - `ein` string, nullable, required — The company's Employer Identification Number. - `ssn` string, 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. - `subscribedServices` QbdSubscribedService, required - `services` QbdService[], required — The list of Intuit services that this company is or has been subscribed to, for example, Intuit Payroll, QBMS. - `name` string, required — The case-insensitive unique name of this service, unique across all services. **NOTE**: Services do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents. - `domain` string, nullable, required — The domain of this subscribed service - `serviceStatus` 'active' | 'expired' | 'never' | 'pending' | 'suspended' | 'terminated' | 'trial', nullable, required — The status of this service's subscription. - `accountantCopy` QbdAccountantCopy, required - `accountantCopyExists` boolean, required — Indicates whether an accountant copy has been made for this company file. An accountant copy allows an accountant to work on the books while the business continues daily operations. - `dividingDate` string, nullable, required — The fiscal period dividing date for accountant work, in ISO 8601 format (YYYY-MM-DD). While an accountant copy exists, transactions within this period cannot be modified or created. New accounts can be added, but existing accounts cannot have new subaccounts, be edited, merged, or made inactive. List items cannot be deleted or merged. - `customFields` QbdCustomField[], required — The custom fields for the company object, added as user-defined data extensions, not included in the standard QuickBooks object. - `ownerId` string, required — The identifier of the owner of the custom field, which QuickBooks internally calls a "data extension". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always "0". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an `ownerId` of "0") for all objects. - `name` string, required — The name of the custom field, unique for the specified `ownerId`. For public custom fields, this name is visible as a label in the QuickBooks UI. - `type` 'amount_type' | 'date_time_type' | 'integer_type' | 'percent_type' | 'price_type' | 'quantity_type' | 'string_1024_type' | 'string_255_type', required — The data type of this custom field. - `value` string, required — The value of this custom field. The maximum length depends on the field's data type. --- [API](https://skmtc.net/conductor-is/apis/conductor-api.md) · [All operations](https://skmtc.net/conductor-is/apis/conductor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductor-is/conductor-api/versions/0b07b3ebe160/schema)