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.
Headers
The ID of the End-User to receive this request.
The ID of the End-User to receive this request.
Response
Returns an object with the company file's information.
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_t2enum value to thetaxForm/anyOf[subschema #1]/response property for the response status200response-property-enum-value-added
- ●
- ●
added the new
form_t1enum value to thetaxForm/anyOf[subschema #1]/response property for the response status200response-property-enum-value-added
- ●
- ▲
response property
companyNamelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
companyTypelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
einlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
emaillist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
faxlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
fiscalYearStartMonthlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
incomeTaxYearStartMonthlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
legalCompanyNamelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
phonelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
ssnlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
taxFormlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
websitelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ○
added
qbd_accountant_copysubschema #2to theaccountantCopyresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_addresssubschema #2to theaddressresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_addresssubschema #2to theaddressForCustomerresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_addresssubschema #2to thelegalAddressresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_subscribed_servicesubschema #2to thesubscribedServicesresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
removed the
aprilenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
aprilenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
augustenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
augustenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
decemberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
decemberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
februaryenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
februaryenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1040enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1065enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1120enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1120senum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_990enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_990pfenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_990tenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
januaryenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
januaryenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
julyenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
julyenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
juneenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
juneenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
marchenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
marchenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mayenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mayenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
novemberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
novemberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
octoberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
octoberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
other_or_noneenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
septemberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
septemberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed
qbd_accountant_copysubschema #2from theaccountantCopyresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_addresssubschema #2from theaddressresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_addresssubschema #2from theaddressForCustomerresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_addresssubschema #2from thelegalAddressresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_subscribed_servicesubschema #2from thesubscribedServicesresponse propertyoneOflist for the response status200response-property-one-of-removed
- ▲
- ▲
the response property
companyNamebecame nullable for the status200response-property-became-nullable
- ▲
the response property
companyTypebecame nullable for the status200response-property-became-nullable
- ▲
the response property
einbecame nullable for the status200response-property-became-nullable
- ▲
the response property
emailbecame nullable for the status200response-property-became-nullable
- ▲
the response property
faxbecame nullable for the status200response-property-became-nullable
- ▲
the response property
fiscalYearStartMonthbecame nullable for the status200response-property-became-nullable
- ▲
the response property
incomeTaxYearStartMonthbecame nullable for the status200response-property-became-nullable
- ▲
the response property
legalCompanyNamebecame nullable for the status200response-property-became-nullable
- ▲
the response property
phonebecame nullable for the status200response-property-became-nullable
- ▲
the response property
ssnbecame nullable for the status200response-property-became-nullable
- ▲
the response property
taxFormbecame nullable for the status200response-property-became-nullable
- ▲
the response property
websitebecame nullable for the status200response-property-became-nullable
- ▲
added
qbd_accountant_copysubschema #2to theaccountantCopyresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
added
qbd_addresssubschema #2to theaddressresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
added
qbd_addresssubschema #2to theaddressForCustomerresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
added
qbd_addresssubschema #2to thelegalAddressresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
added
qbd_subscribed_servicesubschema #2to thesubscribedServicesresponse propertyoneOflist for the response status200response-property-one-of-added
- ●
added the new
aprilenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
aprilenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
augustenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
augustenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
decemberenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
decemberenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
februaryenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
februaryenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_1040enum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_1065enum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_1120enum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_1120senum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_990enum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_990pfenum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
form_990tenum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
januaryenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
januaryenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
julyenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
julyenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
juneenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
juneenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
marchenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
marchenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
mayenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
mayenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
novemberenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
novemberenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
octoberenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
octoberenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
other_or_noneenum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ●
added the new
septemberenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
septemberenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
undefinedenum value to thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
undefinedenum value to theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-added
- ●
added the new
undefinedenum value to thetaxFormresponse property for the response status200response-property-enum-value-added
- ○
removed
qbd_accountant_copysubschema #2from theaccountantCopyresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
qbd_addresssubschema #2from theaddressresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
qbd_addresssubschema #2from theaddressForCustomerresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
qbd_addresssubschema #2from thelegalAddressresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
qbd_subscribed_servicesubschema #2from thesubscribedServicesresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
response property
companyNamelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
companyTypelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
einlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
emaillist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
faxlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
fiscalYearStartMonthlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
incomeTaxYearStartMonthlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
legalCompanyNamelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
phonelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
ssnlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
taxFormlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
websitelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ▲
- ▲
response property
companyNamelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
companyTypelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
einlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
emaillist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
faxlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
fiscalYearStartMonthlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
incomeTaxYearStartMonthlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
legalCompanyNamelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
phonelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
ssnlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
taxFormlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
websitelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ○
added
qbd_accountant_copysubschema #2to theaccountantCopyresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_addresssubschema #2to theaddressresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_addresssubschema #2to theaddressForCustomerresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_addresssubschema #2to thelegalAddressresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
qbd_subscribed_servicesubschema #2to thesubscribedServicesresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
removed the
aprilenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
aprilenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
augustenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
augustenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
decemberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
decemberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
februaryenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
februaryenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1040enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1065enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1120enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_1120senum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_990enum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_990pfenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
form_990tenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
januaryenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
januaryenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
julyenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
julyenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
juneenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
juneenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
marchenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
marchenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mayenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mayenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
novemberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
novemberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
octoberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
octoberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
other_or_noneenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed the
septemberenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
septemberenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thefiscalYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from theincomeTaxYearStartMonthresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thetaxFormresponse property for the response status200response-property-enum-value-removed
- ○
removed
qbd_accountant_copysubschema #2from theaccountantCopyresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_addresssubschema #2from theaddressresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_addresssubschema #2from theaddressForCustomerresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_addresssubschema #2from thelegalAddressresponse propertyoneOflist for the response status200response-property-one-of-removed
- ○
removed
qbd_subscribed_servicesubschema #2from thesubscribedServicesresponse propertyoneOflist for the response status200response-property-one-of-removed
- ▲